LiveBroadcasts

ตอนนี้ API รองรับความสามารถในการตั้งสถานะการถ่ายทอดสดเป็น "สร้างมาเพื่อเด็ก" แล้ว ตอนนี้ทรัพยากร liveBroadcast มีพร็อพเพอร์ตี้ที่ระบุสถานะ "สร้างมาเพื่อเด็ก" ของการถ่ายทอดสดดังกล่าวแล้ว เราได้ปรับปรุงข้อกําหนดในการให้บริการและนโยบายสําหรับนักพัฒนาซอฟต์แวร์ ของบริการ YouTube API ในวันที่ 10 มกราคม 2020 เช่นกัน สําหรับประวัติเพิ่มเติม โปรดอ่านประวัติการแก้ไขสําหรับบริการ API สตรีมมิงแบบสดของ YouTube และข้อกําหนดในการให้บริการของบริการ YouTube API

ทรัพยากร liveBroadcast แสดงถึงกิจกรรมที่จะสตรีมผ่านวิดีโอสดบน YouTube

วิธีการ

API รองรับวิธีต่อไปนี้สําหรับทรัพยากร liveBroadcasts รายการ

list
แสดงรายการการออกอากาศของ YouTube ที่ตรงกับพารามิเตอร์คําขอ API ลองใช้เลย
แทรก
สร้างการออกอากาศ ลองใช้เลย
อัปเดต
อัปเดตประกาศ ตัวอย่างเช่น คุณจะแก้ไขการตั้งค่าการออกอากาศที่กําหนดไว้ในออบเจ็กต์ contentDetails ของทรัพยากร liveBroadcast ได้ ลองใช้เลย
ลบ
ลบประกาศ ลองใช้เลย
เชื่อมโยง
เชื่อมโยงการออกอากาศ YouTube กับสตรีมหรือนําการเชื่อมโยงที่มีอยู่แล้วระหว่างการออกอากาศและสตรีมออก การออกอากาศจะเชื่อมโยงกับสตรีมวิดีโอได้ 1 รายการเท่านั้น แม้ว่าการสตรีมวิดีโออาจเชื่อมโยงกับการออกอากาศมากกว่า 1 รายการได้ ลองใช้เลย
การเปลี่ยน
เปลี่ยนสถานะการถ่ายทอดสดของ YouTube และเริ่มกระบวนการที่เกี่ยวข้องกับสถานะใหม่ เช่น เมื่อคุณเปลี่ยนสถานะการออกอากาศเป็น testing YouTube จะเริ่มส่งวิดีโอไปยังสตรีมการตรวจสอบของการออกอากาศนั้น ก่อนเรียกใช้วิธีนี้ คุณควรยืนยันว่าค่าของพร็อพเพอร์ตี้ status.streamStatus สําหรับสตรีมที่เชื่อมโยงกับการออกอากาศคือ active ลองใช้เลย
จุดเริ่ม
แทรกจุดกึ่งกลางในการถ่ายทอดสด จุดเริ่มโฆษณาอาจทริกเกอร์ช่วงพักโฆษณา

การนําเสนอแหล่งข้อมูล

โครงสร้าง JSON ต่อไปนี้แสดงรูปแบบทรัพยากร liveBroadcasts

{
  "kind": "youtube#liveBroadcast",
  "etag": etag,
  "id": string,
  "snippet": {
    "publishedAt": datetime,
    "channelId": string,
    "title": string,
    "description": string,
    "thumbnails": {
      (key): {
        "url": string,
        "width": unsigned integer,
        "height": unsigned integer
      }
    },
    "scheduledStartTime": datetime,
    "scheduledEndTime": datetime,
    "actualStartTime": datetime,
    "actualEndTime": datetime,
    "isDefaultBroadcast": boolean,
    "liveChatId": string
  },
  "status": {
    "lifeCycleStatus": string,
    "privacyStatus": string,
    "recordingStatus": string,
    "madeForKids": string,
    "selfDeclaredMadeForKids": string,
  },
  "contentDetails": {
    "boundStreamId": string,
    "boundStreamLastUpdateTimeMs": datetime,
    "monitorStream": {
      "enableMonitorStream": boolean,
      "broadcastStreamDelayMs": unsigned integer,
      "embedHtml": string
    },
    "enableEmbed": boolean,
    "enableDvr": boolean,
    "recordFromStart": boolean,
    "enableClosedCaptions": boolean,
    "closedCaptionsType": string,
    "projection": string,
    "enableLowLatency": boolean,
    "latencyPreference": boolean,
    "enableAutoStart": boolean,
    "enableAutoStop": boolean
  },
  "statistics": {
    "totalChatCount": unsigned long
  }
}

พร็อพเพอร์ตี้

ตารางต่อไปนี้กําหนดพร็อพเพอร์ตี้ที่ปรากฏในทรัพยากรนี้

พร็อพเพอร์ตี้
kind string
ระบุประเภทของทรัพยากร API ค่านี้จะเป็น youtube#liveBroadcast
etag etag
Etag ของทรัพยากรนี้
id string
รหัสที่ YouTube กําหนดเพื่อระบุการออกอากาศที่ไม่ซ้ํากัน
snippet object
ออบเจ็กต์ snippet มีรายละเอียดพื้นฐานเกี่ยวกับเหตุการณ์ รวมถึงชื่อ คําอธิบาย เวลาเริ่มต้น และเวลาสิ้นสุด
snippet.publishedAt datetime
วันที่และเวลาที่เพิ่มการออกอากาศในกําหนดการถ่ายทอดสดของ YouTube ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
snippet.channelId string
รหัสที่ YouTube ใช้เพื่อระบุช่องที่กําลังเผยแพร่การออกอากาศที่ไม่ซ้ํากัน
snippet.title string
ชื่อของการออกอากาศ โปรดทราบว่าการออกอากาศแสดงถึงวิดีโอ YouTube เพียง 1 รายการ คุณจะตั้งค่าช่องนี้ได้โดยแก้ไขทรัพยากรการเผยแพร่ หรือตั้งค่าช่อง title ของทรัพยากรวิดีโอที่เกี่ยวข้อง
snippet.description string
คําอธิบายการออกอากาศ เช่นเดียวกับ title คุณสามารถตั้งค่าช่องนี้โดยการแก้ไขทรัพยากรการออกอากาศ หรือโดยการตั้งค่าช่อง description ของทรัพยากรวิดีโอที่เกี่ยวข้อง
snippet.thumbnails object
แผนที่ภาพขนาดย่อที่เชื่อมโยงกับการออกอากาศ สําหรับออบเจ็กต์ที่ฝังแต่ละรายการในออบเจ็กต์นี้ คีย์คือชื่อของภาพขนาดย่อ และค่าคือออบเจ็กต์ที่มีข้อมูลอื่นๆ เกี่ยวกับภาพขนาดย่อ
snippet.thumbnails.(key) object
ค่าคีย์ที่ถูกต้องคือ
  • default – ภาพขนาดย่อเริ่มต้น ภาพขนาดย่อเริ่มต้นสําหรับวิดีโอหรือทรัพยากรที่อ้างอิงถึงวิดีโอ เช่น รายการเพลย์ลิสต์หรือผลการค้นหา มีความกว้าง 120 พิกเซลและสูง 90 พิกเซล ภาพขนาดย่อเริ่มต้นของช่องมีความกว้าง 88 พิกเซลและสูง 88 พิกเซล
  • medium – ภาพขนาดย่อที่มีความละเอียดสูงกว่า สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้จะมีความกว้าง 320 พิกเซลและสูง 180 พิกเซล สําหรับช่อง รูปภาพนี้จะมีความกว้าง 240 พิกเซลและสูง 240 พิกเซล
  • high – ภาพขนาดย่อที่มีความละเอียดสูง สําหรับวิดีโอ (หรือทรัพยากรที่อ้างอิงถึงวิดีโอ) รูปภาพนี้กว้าง 480 พิกเซลและสูง 360 พิกเซล สําหรับช่องหนึ่งๆ รูปภาพนี้จะมีความกว้าง 800 พิกเซลและสูง 800 พิกเซล
snippet.thumbnails.(key).url string
URL ของรูปภาพ
snippet.thumbnails.(key).width unsigned integer
ความกว้างของรูปภาพ
snippet.thumbnails.(key).height unsigned integer
ความสูงของรูปภาพ
snippet.scheduledStartTime datetime
วันที่และเวลาที่เริ่มออกอากาศ ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) Creator Studio รองรับความสามารถในการสร้างการออกอากาศโดยไม่ต้องกําหนดเวลาเริ่มต้น ในกรณีนี้ การออกอากาศจะเริ่มต้นเมื่อใดก็ตามที่เจ้าของช่องเริ่มสตรีม สําหรับการออกอากาศเหล่านี้ ค่า datetime จะสอดคล้องกับ UNIX เวลา 0 ครั้ง และค่านี้ไม่สามารถเปลี่ยนผ่าน API หรือใน Creator Studio
snippet.scheduledEndTime datetime
วันที่และเวลาที่กําหนดให้การถ่ายทอดสดสิ้นสุดลง ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ) หากทรัพยากร liveBroadcast ไม่ได้ระบุค่าสําหรับพร็อพเพอร์ตี้นี้ ก็จะกําหนดเวลาออกอากาศต่อไปเรื่อยๆ ในทํานองเดียวกัน หากคุณไม่ระบุค่าสําหรับพร็อพเพอร์ตี้นี้ YouTube จะถือว่าการประกาศนั้นดําเนินไปอย่างต่อเนื่อง
snippet.actualStartTime datetime
วันที่และเวลาที่ออกอากาศจริง ข้อมูลนี้จะแสดงขึ้นเมื่อสถานะของการออกอากาศเป็น live เท่านั้น ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
snippet.actualEndTime datetime
วันที่และเวลาที่การออกอากาศสิ้นสุดลงจริงๆ ข้อมูลนี้จะแสดงขึ้นเมื่อสถานะของการออกอากาศเป็น complete เท่านั้น ค่านี้ระบุในรูปแบบ ISO 8601 (YYYY-MM-DDThh:mm:ss.sZ)
snippet.isDefaultBroadcast boolean
เราจะเลิกใช้งานพร็อพเพอร์ตี้นี้ในวันที่ 1 กันยายน 2020 เมื่อถึงเวลานั้น YouTube จะหยุดสร้างสตรีมเริ่มต้นและการออกอากาศเริ่มต้นเมื่อช่องเปิดใช้สตรีมมิงแบบสด โปรดดูรายละเอียดเพิ่มเติมในประกาศการเลิกใช้งาน
พร็อพเพอร์ตี้นี้ระบุว่าการออกอากาศนี้เป็นการออกอากาศเริ่มต้นหรือไม่

วิธีการทํางานของการออกอากาศเริ่มต้น

เมื่อเปิดใช้ช่อง YouTube สําหรับสตรีมมิงแบบสด YouTube จะสร้างสตรีมเริ่มต้นและการออกอากาศเริ่มต้นสําหรับช่อง สตรีมจะกําหนดวิธีที่เจ้าของช่องส่งวิดีโอสดไปยัง YouTube และการออกอากาศจะบอกวิธีที่ผู้ชมจะเห็นสตรีมเริ่มต้น เจ้าของช่องสามารถใช้ liveStreams.list และ liveBroadcasts.list เพื่อระบุทรัพยากรเหล่านี้ได้

เมื่อช่องเริ่มสตรีมวิดีโอไปยังสตรีมเริ่มต้น วิดีโอจะแสดงในการออกอากาศเริ่มต้นของช่อง เมื่อสตรีมสิ้นสุดลง YouTube จะแปลงการถ่ายทอดสดที่ดําเนินการเป็นวิดีโอ YouTube และกําหนดรหัสวิดีโอ YouTube ให้กับวิดีโอ

หลังจากที่ Conversion เสร็จสิ้นแล้ว วิดีโอจะรวมอยู่ในรายการวิดีโอที่อัปโหลดของช่อง วิดีโอจะไม่พร้อมให้รับชมหลังจากที่ออกอากาศไปแล้วในทันที และความยาวของการหน่วงเวลาจะเกี่ยวข้องกับความยาวจริงของการออกอากาศ
snippet.liveChatId string
รหัสสําหรับแชทสดของ YouTube ที่ออกอากาศ รหัสนี้จะช่วยให้คุณใช้วิธีของทรัพยากรของ liveChatMessage เพื่อดึง แทรก หรือลบข้อความแชทได้ คุณยังสามารถเพิ่มหรือนําผู้ดูแลแชทออก แบนผู้ใช้ไม่ให้เข้าร่วมแชทสด หรือนําการแบนที่มีอยู่ออก
status object
ออบเจ็กต์ status มีข้อมูลเกี่ยวกับสถานะของเหตุการณ์
status.lifeCycleStatus string
สถานะของการออกอากาศ สามารถอัปเดตสถานะโดยใช้เมธอด liveBroadcasts.transition ของ API

ค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้นี้คือ
  • complete – การออกอากาศเสร็จสิ้น
  • created - การออกอากาศมีการตั้งค่าที่ไม่สมบูรณ์ จึงยังไม่พร้อมที่จะเปลี่ยนสถานะเป็น live หรือ testing แต่สร้างขึ้นแล้วและถูกต้อง
  • live – การออกอากาศทํางานอยู่
  • liveStarting – การออกอากาศกําลังเปลี่ยนไปเป็นสถานะ live
  • ready – การตั้งค่าการออกอากาศเสร็จสิ้นและการออกอากาศจะเปลี่ยนเป็นสถานะ live หรือ testing
  • revoked - ผู้ดูแลระบบได้นําประกาศนี้ออกแล้ว
  • testStarting – การออกอากาศกําลังเปลี่ยนไปเป็นสถานะ testing
  • testing – การออกอากาศจะแสดงต่อพาร์ทเนอร์เท่านั้น
status.privacyStatus string
สถานะความเป็นส่วนตัวของการออกอากาศ โปรดทราบว่าการออกอากาศแสดงถึงวิดีโอ YouTube เพียง 1 รายการเท่านั้น ดังนั้นการตั้งค่าความเป็นส่วนตัวจะเหมือนกับวิดีโอที่รองรับ นอกจากนี้ คุณยังตั้งค่าช่องนี้ได้โดยแก้ไขทรัพยากรการเผยแพร่ หรือตั้งค่าช่อง privacyStatus ของทรัพยากรวิดีโอที่เกี่ยวข้อง

ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้ ได้แก่
  • private
  • public
  • unlisted
status.recordingStatus string
สถานะการบันทึกของการออกอากาศ

ค่าที่ถูกต้องสําหรับพร็อพเพอร์ตี้นี้คือ
  • notRecording
  • recorded
  • recording
status.madeForKids boolean
ค่านี้จะระบุว่าการออกอากาศนั้นมีเด็กเป็นกลุ่มเป้าหมายหรือไม่ ค่าพร็อพเพอร์ตี้นี้เป็นแบบอ่านอย่างเดียว
status.selfDeclaredMadeForKids boolean
ในคําขอ liveBroadcasts.insert พร็อพเพอร์ตี้นี้อนุญาตให้เจ้าของช่องระบุว่าการออกอากาศมีเด็กเป็นกลุ่มเป้าหมาย ในคําขอ liveBroadcasts.list จะแสดงค่าพร็อพเพอร์ตี้ก็ต่อเมื่อเจ้าของช่องให้สิทธิ์คําขอ API เท่านั้น
contentDetails object
ออบเจ็กต์ contentDetails มีข้อมูลเกี่ยวกับเนื้อหาวิดีโอของกิจกรรม เช่น กําหนดว่าเนื้อหาจะปรากฏในโปรแกรมเล่นวิดีโอแบบฝังได้หรือไม่ หรือจะเก็บข้อมูลนั้นไว้ไหม และพร้อมให้ดูหลังจากที่กิจกรรมจบแล้ว
contentDetails.boundStreamId string
ค่านี้ระบุ live stream ที่ผูกไว้กับการออกอากาศที่ไม่ซ้ํากัน
contentDetails.boundStreamLastUpdateTimeMs datetime
วันที่และเวลาที่สตรีมแบบสดที่อ้างอิงโดย boundStreamId ได้รับการอัปเดตครั้งล่าสุด
contentDetails.monitorStream object
ออบเจ็กต์ monitorStream มีข้อมูลเกี่ยวกับสตรีมการตรวจสอบ ซึ่งผู้ออกอากาศสามารถใช้เพื่อตรวจสอบเนื้อหาเหตุการณ์ก่อนที่สตรีมการออกอากาศจะปรากฏแบบสาธารณะ
contentDetails.monitorStream.enableMonitorStream boolean
ค่านี้จะระบุว่ามีการเปิดใช้สตรีมการตรวจสอบสําหรับการออกอากาศหรือไม่ หากเปิดใช้สตรีมการตรวจสอบ YouTube จะเผยแพร่เนื้อหากิจกรรมในสตรีมพิเศษที่มีไว้สําหรับการใช้งานของผู้ออกอากาศเท่านั้น ผู้เผยแพร่เนื้อหาสามารถใช้สตรีมเพื่อตรวจสอบเนื้อหาของกิจกรรมและระบุช่วงเวลาที่เหมาะสมในการแทรกจุดเริ่มโฆษณา

คุณจะต้องตั้งค่านี้เป็น true หากคุณต้องการมีขั้นตอน testing สําหรับการออกอากาศ หรือหากต้องการให้การออกอากาศล่าช้าสําหรับกิจกรรมของคุณ นอกจากนี้ หากค่าของพร็อพเพอร์ตี้นี้คือ true คุณต้องเปลี่ยนการออกอากาศเป็นสถานะ testing ก่อนจึงจะเปลี่ยนเป็นสถานะ live ได้ (หากค่าของพร็อพเพอร์ตี้คือ false การออกอากาศของคุณจะมีขั้นตอน testing ไม่ได้ คุณจึงเปลี่ยนให้การออกอากาศเป็นสถานะ live ได้โดยตรง)

เมื่อ update a broadcast ต้องตั้งค่าพร็อพเพอร์ตี้นี้หากคําขอ API มีส่วน contentDetails ในค่าพารามิเตอร์ part อย่างไรก็ตาม เมื่อคุณ insert a broadcast พร็อพเพอร์ตี้จะเป็นพร็อพเพอร์ตี้ที่ไม่บังคับและมีค่าเริ่มต้นเป็น true

สําคัญ: คุณไม่สามารถอัปเดตพร็อพเพอร์ตี้นี้เมื่อการออกอากาศอยู่ในสถานะ testing หรือ live
contentDetails.monitorStream.broadcastStreamDelayMs unsigned integer
หากคุณตั้งค่าพร็อพเพอร์ตี้ enableMonitorStream เป็น true พร็อพเพอร์ตี้นี้จะกําหนดความยาวของความล่าช้าในการถ่ายทอดสด

เมื่อ update a broadcast ต้องตั้งค่าพร็อพเพอร์ตี้นี้หากคําขอ API มีส่วน contentDetails ในค่าพารามิเตอร์ part อย่างไรก็ตาม เมื่อคุณ insert a broadcast พร็อพเพอร์ตี้จะเป็นพร็อพเพอร์ตี้ที่ไม่บังคับและมีค่าเริ่มต้นเป็น 0 ค่านี้บ่งบอกว่าการออกอากาศไม่มีการหน่วงเวลาออกอากาศ หมายเหตุ: คุณไม่สามารถอัปเดตพร็อพเพอร์ตี้นี้เมื่อการออกอากาศอยู่ในสถานะ testing หรือ live
contentDetails.monitorStream.embedHtml string
โค้ด HTML ที่ฝังโปรแกรมเล่นที่เล่นสตรีมจอภาพ
contentDetails.enableEmbed boolean
การตั้งค่านี้ระบุว่าวิดีโอประกาศจะเล่นในโปรแกรมเล่นแบบฝังได้หรือไม่ หากเลือกเก็บวิดีโอ (โดยใช้พร็อพเพอร์ตี้ enableArchive) การตั้งค่านี้จะใช้กับวิดีโอที่เก็บถาวรด้วย

เมื่อ update a broadcast ต้องตั้งค่าพร็อพเพอร์ตี้นี้หากคําขอ API มีส่วน contentDetails ในค่าพารามิเตอร์ part อย่างไรก็ตาม เมื่อคุณ insert a broadcast พร็อพเพอร์ตี้จะเป็นพร็อพเพอร์ตี้ที่ไม่บังคับและมีค่าเริ่มต้นเป็น true

หมายเหตุ: อัปเดตพร็อพเพอร์ตี้นี้ไม่ได้เมื่อการออกอากาศอยู่ในสถานะ testing หรือ live
contentDetails.enableDvr boolean
การตั้งค่านี้เป็นตัวกําหนดว่าผู้ดูจะเข้าถึงการควบคุม DVR ขณะดูวิดีโอได้หรือไม่ การควบคุม DVR ช่วยให้ผู้ชมควบคุมประสบการณ์การเล่นวิดีโอได้โดยการหยุดเนื้อหาชั่วคราว กรอกลับ หรือกรอไปข้างหน้า ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ true

เมื่อ update a broadcast ต้องตั้งค่าพร็อพเพอร์ตี้นี้หากคําขอ API มีส่วน contentDetails ในค่าพารามิเตอร์ part อย่างไรก็ตาม เมื่อคุณ insert a broadcast พร็อพเพอร์ตี้จะเป็นพร็อพเพอร์ตี้ที่ไม่บังคับและมีค่าเริ่มต้นเป็น true

สําคัญ: คุณต้องกําหนดค่าเป็น true และกําหนดค่าของพร็อพเพอร์ตี้ enableArchive เป็น true หากต้องการให้เล่นได้ทันทีหลังการออกอากาศสิ้นสุดลง นอกจากนี้ คุณจะอัปเดตพร็อพเพอร์ตี้นี้ไม่ได้เมื่อการออกอากาศอยู่ในสถานะ testing หรือ live
contentDetails.recordFromStart boolean
การตั้งค่านี้ระบุว่า YouTube จะเริ่มบันทึกการออกอากาศโดยอัตโนมัติหลังจากที่สถานะของกิจกรรมเปลี่ยนเป็นการถ่ายทอดสดหรือไม่

ค่าเริ่มต้นของพร็อพเพอร์ตี้นี้คือ true และจะตั้งค่าเป็น false ได้เฉพาะในกรณีที่ช่องออกอากาศได้รับอนุญาตให้ปิดใช้การบันทึกสําหรับการถ่ายทอดสด

หากช่องของคุณไม่มีสิทธิ์ปิดใช้การบันทึก และคุณพยายามแทรกการออกอากาศที่มีพร็อพเพอร์ตี้ recordFromStart ตั้งค่าเป็น false API จะแสดงข้อผิดพลาด Forbidden นอกจากนี้ หากช่องของคุณไม่มีสิทธิ์ดังกล่าว และคุณพยายามอัปเดตการออกอากาศเพื่อตั้งค่าพร็อพเพอร์ตี้ recordFromStart เป็น false API จะแสดงข้อผิดพลาด modificationNotAllowed

เมื่อ update a broadcast ต้องตั้งค่าพร็อพเพอร์ตี้นี้หากคําขอ API มีส่วน contentDetails ในค่าพารามิเตอร์ part อย่างไรก็ตาม เมื่อคุณ insert a broadcast พร็อพเพอร์ตี้จะเป็นพร็อพเพอร์ตี้ที่ไม่บังคับและมีค่าเริ่มต้นเป็น true

สําคัญ: คุณต้องกําหนดมูลค่าของ enableDvr เป็น true หากต้องการให้การเล่นพร้อมใช้งานทันทีหลังจากการออกอากาศสิ้นสุดลง หากคุณตั้งค่าพร็อพเพอร์ตี้นี้เป็น true แต่ไม่ได้ตั้งค่าพร็อพเพอร์ตี้ enableDvr เป็น true ด้วย อาจเกิดความล่าช้าประมาณ 1 วันก่อนที่วิดีโอที่เก็บถาวรจะพร้อมเล่น

หมายเหตุ: อัปเดตพร็อพเพอร์ตี้นี้ไม่ได้เมื่อการออกอากาศอยู่ในสถานะ testing หรือ live
contentDetails.enableClosedCaptions boolean
เราได้เลิกใช้งานพร็อพเพอร์ตี้นี้ตั้งแต่วันที่ 17 ธันวาคม 2015 ใช้พร็อพเพอร์ตี้ contentDetails.closedCaptionsType แทน

การตั้งค่านี้บ่งบอกว่ามีการเปิดใช้คําบรรยาย HTTP POST สําหรับการออกอากาศนี้หรือไม่ สําหรับไคลเอ็นต์ API ที่ใช้พร็อพเพอร์ตี้นี้แล้ว
  • การตั้งค่าพร็อพเพอร์ตี้เป็น true เทียบเท่ากับการตั้งค่าพร็อพเพอร์ตี้ contentDetails.closedCaptionsType เป็น closedCaptionsHttpPost
  • การตั้งค่าพร็อพเพอร์ตี้เป็น false เทียบเท่ากับการตั้งค่าพร็อพเพอร์ตี้ contentDetails.closedCaptionsType เป็น closedCaptionsDisabled
contentDetails.closedCaptionsType string
หมายเหตุ: พร็อพเพอร์ตี้นี้จะแทนที่พร็อพเพอร์ตี้ contentDetails.enableClosedCaptions

พร็อพเพอร์ตี้นี้จะระบุว่ามีการเปิดใช้คําบรรยายสําหรับการออกอากาศของคุณหรือไม่ และหากจําเป็น คุณต้องระบุคําบรรยายประเภทใด
  • closedCaptionsDisabled: คําบรรยายสําหรับการถ่ายทอดสดปิดอยู่
  • closedCaptionsHttpPost: คุณจะส่งคําบรรยายผ่าน HTTP POST ไปยัง URL การส่งผ่านข้อมูลที่เชื่อมโยงกับสตรีมแบบสด
  • closedCaptionsEmbedded: คําบรรยายจะเข้ารหัสในสตรีมวิดีโอโดยใช้รูปแบบ EIA-608 และ/หรือ CEA-708
contentDetails.projection string
รูปแบบการคาดการณ์ของการออกอากาศนี้ ค่าเริ่มต้นของพร็อพเพอร์ตี้คือ rectangular

ค่าที่ถูกต้องของพร็อพเพอร์ตี้นี้คือ
  • 360
  • rectangular
contentDetails.enableLowLatency boolean
ระบุว่าการออกอากาศนี้ควรเข้ารหัสสําหรับการสตรีมที่มีเวลาในการตอบสนองต่ําหรือไม่ สตรีมที่มีเวลาในการตอบสนองต่ําจะลดระยะเวลาที่วิดีโอปรากฏต่อผู้ใช้ที่ดูการออกอากาศได้ แต่อาจส่งผลต่อความละเอียดของผู้ดูสตรีมด้วย
contentDetails.latencyPreference string
ระบุการตั้งค่าเวลาในการตอบสนองที่จะใช้สําหรับการออกอากาศนี้ อาจใช้พร็อพเพอร์ตี้นี้แทน enableLowLatency ซึ่งไม่รองรับ ultraLow

สตรีมที่มีเวลาในการตอบสนองต่ําจะลดระยะเวลาที่วิดีโอปรากฏต่อผู้ใช้ที่ดูการออกอากาศได้ แต่ก็อาจส่งผลต่อความลื่นไหลในการเล่นด้วย

สตรีมที่มีเวลาในการตอบสนองต่ําจะลดเวลาที่ต้องใช้ในการแสดงวิดีโอ ส่งผลให้การโต้ตอบกับผู้ชมทําได้ง่ายขึ้น
  • normal
  • low
  • ultraLow
  • contentDetails.enableAutoStart boolean
    ระบุว่าการออกอากาศนี้ควรเริ่มโดยอัตโนมัติเมื่อคุณเริ่มสตรีมวิดีโอบนขอบเขต live stream หรือไม่
    contentDetails.enableAutoStop boolean
    ระบุว่าการออกอากาศนี้ควรหยุดโดยอัตโนมัติประมาณ 1 นาทีหลังจากเจ้าของช่องหยุดสตรีมวิดีโอในการเชื่อมโยงวิดีโอไหม
    statistics object
    ออบเจ็กต์ statistics มีสถิติเกี่ยวกับการถ่ายทอดสด ค่าสถิติเหล่านี้สามารถเปลี่ยนแปลงในระหว่างการออกอากาศ และเรียกดูได้ในขณะที่เผยแพร่เท่านั้น
    statistics.totalChatCount unsigned long
    จํานวนข้อความแชทสดทั้งหมดที่เชื่อมโยงกับการออกอากาศ ที่พักและค่าของที่พักจะปรากฏขึ้นหากผู้ใช้เห็นการออกอากาศ เปิดใช้ฟีเจอร์แชทสด และมีข้อความอย่างน้อย 1 ข้อความ โปรดทราบว่าพร็อพเพอร์ตี้นี้ไม่ได้ระบุค่าหลังจากการออกอากาศสิ้นสุดลง ดังนั้น พร็อพเพอร์ตี้นี้จะไม่ระบุจํานวนข้อความแชทสําหรับวิดีโอที่เก็บถาวรของการถ่ายทอดสดที่เสร็จสมบูรณ์