מדריך העברה להוצאת שידורים ומקורות נתונים המוגדרים כברירת מחדל

סקירה כללית

המדריך הזה מיועד למפתחים של אפליקציות לקוח API שמשתמשות במשאבי ברירת המחדל של liveStream וערוצי liveBroadcast לשידור ערוצים בשידור חי ב-YouTube. הוא נועד לעזור לך להבטיח שהאפליקציה שלך מטפלת בחינניות בשידורי ברירת המחדל ובשידורים שמוגדרים כברירת מחדל, והיא רלוונטית עבורך אם אחת מההצהרות הבאות חלה על האפליקציה שלך:

  • הוא בודק את הערך של הנכס isDefaultBroadcast של המשאב liveBroadcast.
  • הוא בודק את הערך של הנכס isDefaultStream של המשאב liveStream.

  • הוא קורא לשיטה liveBroadcasts.list ומגדיר את ערך הפרמטר broadcastType ל-persistent. נכון לתאריך ההוצאה משימוש:

    • אם ערך הפרמטר broadcastType הוא persistent, השיטה liveBroadcasts.list לא תחזיר תוצאות.
    • אם ערך הפרמטר broadcastType הוא all, אז השיטה liveBroadcasts.list לא תחזיר שידורים קבועים שהיו קיימים לפני כן.

אם הבקשה שלכם מושפעת, עיינו בקטע עדכון האפליקציה, שבו מוסבר מהם השינויים הפרוצדורליים שנדרשים לאפליקציה כדי להוציא משימוש. בקטע הזה מתוארים שלבים ספציפיים במדריך אורך החיים של השידור, שהלקוח של ה-API שלכם לא בדרך כלל עוקב אחריהם אם הוא משתמש כרגע בשידור ובסטרימינג שמוגדרים כברירת מחדל.

מה קורה?

משנת 2015, המערכת של YouTube יוצרת באופן אוטומטי שידור ברירת מחדל ושידור ברירת מחדל של הערוץ, כאשר הוא הופעל לסטרימינג בשידור חי. זרם ברירת המחדל היה קיים ללא הגבלת זמן, ולא ניתן היה למחוק אותו. באופן דומה, שידור ברירת המחדל נחשב קבוע. הוא היה קיים תמיד, לא שויך אליו שעת התחלה או שעת סיום, והוא לא היה קשור לאירוע מסוים.

החל מתאריך ההוצאה משימוש שצוין למעלה, מערכת YouTube כבר לא תיצור שידורים ושידורים שמוגדרים כברירת מחדל. השינוי הזה משפיע על אפליקציות לקוח שמתבססות על המשאבים האלה כדי לשדר תוכן בשידור חי. היא תשפיע גם על אפליקציות שבהן ממשק המשתמש מותאם אישית כדי להבדיל בין משאבי ברירת המחדל האלה לבין שאר השידורים ובעלי התוכן שיצרו בעלי הערוץ.

במקום להסתמך על משאבי ברירת המחדל, לקוחות של ממשקי API צריכים ליצור ולנהל משאבי liveBroadcast ו-liveStream ולאחד את המשאבים האלה.

האפליקציה מתעדכנת

כדי לראות את הטרמינולוגיה במהירות, המונח שדר מייצג אירוע שניתן לצפייה ב-YouTube בזמן שהוא קורה, ושידור הוא המנגנון לשליחת תוכן הווידאו בפועל ל-YouTube. שידור יכול להיות, וצריך להיות מוגבל, לזרם אחד בדיוק.

מעבר משידורי ברירת מחדל

לפני ההוצאה משימוש, לקוחות API יכלו לבחור אם להשתמש בשידור ברירת מחדל של ערוץ או ליצור שידור ספציפי לאירוע. שידור ברירת המחדל היה משאב קבוע שאפשר לעשות בו שימוש חוזר במספר אירועים, ואילו משאב שידור ספציפי לאירוע הוא משאב לשימוש חד-פעמי שתואם בדיוק לסרטון אחד ב-YouTube.

אפליקציית הלקוח משתמשת בשידור ברירת המחדל אם היא מפעילה את השיטה liveBroadcasts.list ומבצעת אחת מהפעולות הבאות:

  • היא מגדירה את ערך הפרמטר broadcastType כ-persistent. הבקשה הזו מאחזרת רק את שידור ברירת המחדל.
  • היא מגדירה את ערך הפרמטר broadcastType ל-all, ואז מזהה את המשאב liveBroadcast בתגובת ה-API שהערך של המאפיין isDefaultBroadcast הוא true.

לאחר ההוצאה משימוש, מערכת YouTube תתמוך רק בשידורים ספציפיים לאירועים. פירוש הדבר שבמקום להסתמך על שידור ברירת המחדל, אפליקציות של לקוחות צריכות ליצור משאבים של liveBroadcast לכל אירוע שידור נפרד.

כדי ליצור משאב אחד (liveBroadcast), צריך לקרוא לשיטה liveBroadcasts.insert. תהליך זה מוסבר בשלב 1.1 של המדריך "חיים של שידור".

ממשק המשתמש צריך לספק מנגנונים שמאפשרים לו להבחין בין שידורים קרובים ספציפיים לאירוע ולבחור ביניהם.

מעבר משידורי ברירת מחדל

שידור מאפשר לכם לשדר תוכן של אודיו וידאו ל-YouTube, והוא קובע את ההגדרות לשידור של תוכן ב-YouTube. בדרך כלל השידורים האלה משתמשים באותו שידור בשידורים רבים אחרים, אם השידורים האלה מתבצעים בזמנים שונים.

האפליקציה לא יכולה להשתמש בשידור ברירת המחדל, אבל היא יכולה ליצור שידור חוזר לשימוש חוזר עבור כל שידור. כדי ליצור משאב liveStream, יש לקרוא לשיטה liveStreams.insert ולפעול לפי ההוראות המפורטות בשלב 1.2 של המדריך "חיים של שידור". כברירת מחדל, אפשר להשתמש בהם שוב בסטרימינג חדש. עם זאת, אם אתם מעדיפים, תוכלו להגדיר את הנכס contentDetails.isReusable ל-false כדי ליצור שידורים חד-פעמיים ולשמור על קשר אחד-על-אחד בין שידורים לבין שידורים.

הרשימה הבאה כוללת את ארבעת המאפיינים, מלבד כותרת מקור הנתונים ותיאור מקור הנתונים, שאפשר להגדיר כשיוצרים שידור חדש. ברשימה הזו מופיעים הערכים שמוגדרים כברירת מחדל לכל נכס בנפרד, וסביר להניח שההגדרה היא ברירת המחדל שצריך להשתמש בה באפליקציית הלקוח אם מפסיקים להשתמש בסטרימינג מהגדרות ברירת מחדל.

קישור שידורים לשידורים חיים

כל משאב של liveBroadcast חייב להיות מקושר לזרם אחד בדיוק לפני שהשידור החי ב-YouTube יכול להתחיל בפועל. (שידור זה אינו כפוף לשום מקור נתונים בעת יצירתו).

תהליך הקישור טופל באופן אוטומטי עבור שידור ברירת המחדל, שהיה קשור באופן בלתי הפיך לזרם ברירת המחדל. עם זאת, לאחר תאריך ההוצאה משימוש, אפליקציות של לקוחות צריכות לנהל את התהליך הזה בכל השידורים.

כדי לקשר שידור לשידור, קראו לשיטה liveBroadcasts.bind כפי שמוסבר בשלב 1.3 של המדריך "החיים של שידור".

  • אם אתם משתמשים בשידור חוזר לשימוש חוזר, אתם יכולים ליצור שידור פעם אחת ולאחר מכן לקשר את כל השידור.
  • אם אתם לא משתמשים בשידור חוזר לשימוש חוזר, עליכם ליצור שידור וזרם ולקשר את שניהם.

בדיקת השידור שלך

אם לא משתמשים בשידור ברירת המחדל, אפשר לבדוק את השידור. כדי לבצע בדיקה, אתם מטמיעים נגן שמאפשר לצפות בתצוגה מקדימה של שידור הווידאו כפי שהוא יוצג לצופים ב-YouTube, אבל השידור לא גלוי לצופים אחרים.

אם לקוח ה-API שלכם השתמש בעבר בשידור ובסטרימינג המוגדרים כברירת מחדל, ואתם רוצים להוסיף שלב בדיקה לתהליך השידור, קראו את שלב 3 במדריך "החיים של שידור".

אם אתם רוצים לבדוק את השידור, אם מוסיפים שידור, צריך להגדיר את הנכס contentDetails.monitorStream.enableMonitorStreamtrue ואת המאפיין contentDetails.enableAutoStartfalse. אלו ערכי ברירת המחדל בשני הנכסים.

להשתמש בתכונות 'הפעלה אוטומטית' ו'הפסקה אוטומטית'

שידור ברירת המחדל התחיל אוטומטית בכל פעם שהתחלתם לשדר וידאו בסטרימינג בשידור ברירת המחדל. באופן דומה, שידור ברירת המחדל הסתיים לאחר שהפסקת את שידור הווידאו. כל סשן סטרימינג באמצעות משאבי ברירת המחדל האלה הפך לאחר מכן לסרטון בערוץ שלכם.

בעוד שהתכונות של הפעלה אוטומטית והפסקה אוטומטית היו התנהגות ברירת המחדל של שידורי ברירת מחדל, השימוש בתכונות האלה הוא אופציונלי ויש להפעיל אותן עבור שידורים אחרים. אם אתם רוצים להשתמש בתכונות האלה, כשמוסיפים שידור, צריך להגדיר את ערכי המאפיין contentDetails.enableAutoStart ו-contentDetails.enableAutoStop true. התכונות האלה עצמאיות, כך שאפשר לבחור להשתמש בתכונה אחת ולא באחרת.

אם אתם לא מפעילים את תכונות ההפעלה האוטומטית וההפסקה האוטומטית של שידורים חדשים, לקוח ה-API שלכם צריך לקרוא לשיטה liveBroadcasts.transition כדי לעדכן את הסטטוס של השידור כשאתם מתחילים או מסיימים את שידור הווידאו. במדריך "החיים של שידור", עיינו בשלב 4.3 ובשלב 5.2 כדי לקבל הוראות לניהול המעברים האלה בתחילת השידור ובסופו.