แอตทริบิวต์ของโปรแกรมวิดีโอจะขึ้นอยู่กับประเภทของเนื้อหา ประเภทโปรแกรม บอกให้ระบบทราบถึงข้อมูลเมตาที่ต้องการเพื่อให้ใส่ 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
แอตทริบิวต์ที่มีเครื่องหมาย ✔ เป็นแอตทริบิวต์ที่ต้องระบุ จะใส่เครื่องหมาย (✔) หรือไม่ก็ได้
แอตทริบิวต์ | ภาพยนตร์ | TV ซีรี่ส์ | ซีซันรายการทีวี | รายการโทรทัศน์เป็นตอน | คลิป | กิจกรรม | ช่อง |
---|---|---|---|---|---|---|---|
ผู้เขียน | (✔) | ||||||
ความพร้อมใช้งาน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
ประเภท Canonical | (✔) | (✔) | (✔) | (✔) | |||
รหัสช่อง | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
Content ID | (✔) | ||||||
การจัดประเภทเนื้อหา | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
ระยะเวลามิลลิวินาที | ✔ | ✔ | ✔ | (✔) | |||
หมายเลขตอน | ✔ | ||||||
ชื่อตอน | (✔) | ||||||
ประเภท | (✔) | (✔) | (✔) | (✔) | |||
URL ของ Intent | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
จำนวนการโต้ตอบ | (✔) | (✔) | |||||
ประเภทการโต้ตอบ | (✔) | (✔) | |||||
รหัสผู้ให้บริการภายใน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
จำนวนรายการ | (✔) | (✔) | |||||
เผยแพร่อยู่ | (✔) | (✔) | (✔) | (✔) | (✔) | ||
URI ของโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
คำอธิบายเนื้อหาของโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
ราคาข้อเสนอ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
สัดส่วนภาพของภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
URI ของภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
ตัวอย่าง URI ของวิดีโอ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
วันที่เผยแพร่ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
รูปแบบการให้คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
หมายเลขที่แสดงของซีซัน | ✔ | ✔ | |||||
คำอธิบายแบบสั้น | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
เวลาเริ่มต้น UTC มิลลิวินาที (*) | ✔ | ✔ | ✔ | ✔ | |||
เวลาสิ้นสุด UTC มิลลิวินาที (*) | ✔ | ✔ | ✔ | ✔ | |||
ราคาเริ่มต้น | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
สัดส่วนภาพของภาพขนาดย่อ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
URL ของภาพขนาดย่อ | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
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