คุณลักษณะของโปรแกรมวิดีโอขึ้นอยู่กับประเภทของเนื้อหา ประเภทโปรแกรม จะบอกระบบว่าควรคาดหวังข้อมูลเมตาใดเพื่อให้ระบบป้อนข้อมูลใน UI ได้ อย่างเหมาะสม
โปรแกรมวิดีโออาจเป็นประเภทใดประเภทหนึ่งต่อไปนี้
ใช้ PreviewProgram.Builder เพื่อสร้างโปรแกรม คุณอ่านเพิ่มเติมเกี่ยวกับ
ค่าที่เป็นไปได้สำหรับแต่ละฟิลด์ได้ในเอกสารอ้างอิงสำหรับแต่ละตัวตั้งค่าใน
บิลเดอร์
Kotlin
val program = PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build()
Java
PreviewProgram program = new PreviewProgram.Builder()
.setChannelId(channelId)
.setTitle(clip.getTitle())
.setDescription(clip.getDescription())
.setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE)
// Set required attributes
.build();
ตารางต่อไปนี้แสดงแอตทริบิวต์ที่กำหนดให้กับวิดีโอโปรแกรมแต่ละประเภทได้
คุณลักษณะแต่ละอย่างจะเชื่อมโยงกับตัวกำหนดค่าที่เกี่ยวข้องในPreviewProgram.Builder.
แอตทริบิวต์ที่มีเครื่องหมาย ✔ กำกับเป็นแอตทริบิวต์ที่ต้องระบุ ส่วนแอตทริบิวต์ที่มีเครื่องหมาย (✔) กำกับเป็นแอตทริบิวต์ที่ไม่บังคับ
| แอตทริบิวต์ | ภาพยนตร์ | ซีรีส์ | ซีซันรายการทีวี | รายการโทรทัศน์เป็นตอน | คลิป | กิจกรรม | ช่อง |
|---|---|---|---|---|---|---|---|
| ผู้เขียน | (✔) | ||||||
| ความพร้อมใช้งาน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ประเภท Canonical | (✔) | (✔) | (✔) | (✔) | |||
| รหัสช่อง | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| การจัดประเภทเนื้อหา | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| หมายเลขตอน | ✔ | ||||||
| ชื่อตอน | (✔) | ||||||
| ประเภท | (✔) | (✔) | (✔) | (✔) | |||
| URI ของความตั้งใจ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| จำนวนการโต้ตอบ | (✔) | (✔) | |||||
| ประเภทการโต้ตอบ | (✔) | (✔) | |||||
| รหัสผู้ให้บริการภายใน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| จำนวนสินค้า | (✔) | (✔) | |||||
| ไลฟ์สด | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| URI ของโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| คำอธิบายเนื้อหาโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ราคาในข้อเสนอ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| อัตราส่วนภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI ของภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI ของวิดีโอตัวอย่าง | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| วันที่เปิดตัว | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| รูปแบบการให้คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| หมายเลขที่แสดงของซีซัน | ✔ | ✔ | |||||
| คำอธิบายแบบสั้น | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| เวลาเริ่มต้น UTC Millis (*) | ✔ | ✔ | ✔ | ✔ | |||
| เวลาสิ้นสุด (มิลลิวินาที UTC) (*) | ✔ | ✔ | ✔ | ✔ | |||
| ราคาเริ่มต้น | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| สัดส่วนภาพของภาพปก | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| URI ของภาพปก | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Title | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| ความสูงของวิดีโอ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ความกว้างของวิดีโอ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| น้ำหนัก | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
ภาพตัวอย่าง
ขนาดภาพตัวอย่างที่แนะนำมีดังนี้:
| แอตทริบิวต์ | สัดส่วนภาพ | ความกว้าง | ส่วนสูง |
ASPECT_RATIO_16_9 |
16:9 | 272 dp | 153 dp |
ASPECT_RATIO_3_2 |
3:2 | 229.5 dp | 153 dp |
ASPECT_RATIO_4_3 |
4:3 | 204 dp | 153 dp |
ASPECT_RATIO_1_1 |
1:1 | 153 dp | 153 dp |
ASPECT_RATIO_2_3 |
2:3 | 102 dp | 153 dp |
ASPECT_RATIO_MOVIE_POSTER |
1:1.441 | 106 dp | 153 dp |
หากต้องการคุณภาพที่ดีที่สุด ให้ใช้วิดีโอตัวอย่างที่มีสัดส่วนภาพ 16:9 หรือ 4:3 ซึ่งมีขนาดอย่างน้อยเท่ากับที่ระบุไว้ในตารางนี้ ใช้โลโก้แบบทึบแสงเพื่อประสบการณ์การใช้งานที่ดีที่สุด
คุณสามารถระบุขนาดวิดีโอตัวอย่างที่แน่นอนได้โดยใช้ VIDEO_WIDTH และ VIDEO_HEIGHT