แอตทริบิวต์ของรายการวิดีโอจะขึ้นอยู่กับประเภทเนื้อหา ประเภทรายการจะบอกระบบว่าควรคาดหวังข้อมูลเมตาใด เพื่อให้สามารถกรอกข้อมูลใน UI ได้อย่างเหมาะสม
รายการวิดีโออาจเป็นประเภทใดประเภทหนึ่งต่อไปนี้
ใช้ PreviewProgram.Builder เพื่อสร้างโปรแกรม คุณอ่านข้อมูลเพิ่มเติมเกี่ยวกับค่าที่เป็นไปได้สำหรับแต่ละฟิลด์ได้ในเอกสารอ้างอิงสำหรับ Setter แต่ละรายการใน Builder
val program = PreviewProgram.Builder() .setChannelId(channelId) .setTitle(clip.getTitle()) .setDescription(clip.getDescription()) .setType(TvContractCompat.PreviewPrograms.TYPE_MOVIE) // Set required attributes. .build()
ตารางต่อไปนี้แสดงแอตทริบิวต์ที่กำหนดให้กับรายการวิดีโอแต่ละประเภทได้ แอตทริบิวต์แต่ละรายการจะลิงก์ไปยัง Setter ที่เกี่ยวข้องใน PreviewProgram.Builder
แอตทริบิวต์ที่มีเครื่องหมาย ✔ เป็นแอตทริบิวต์ที่ต้องระบุ ส่วนแอตทริบิวต์ที่มีเครื่องหมาย (✔) เป็นแอตทริบิวต์ที่ไม่บังคับ
| แอตทริบิวต์ | ภาพยนตร์ | ซีรีส์ | ซีซันทีวี | รายการโทรทัศน์เป็นตอน | คลิป | กิจกรรม | ช่อง |
|---|---|---|---|---|---|---|---|
| Author | (✔) | ||||||
| ความพร้อมใช้งาน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ประเภท Canonical | (✔) | (✔) | (✔) | (✔) | |||
| รหัสช่อง | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| Content ID | (✔) | ||||||
| การจัดประเภทเนื้อหา | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| DurationMillis | ✔ | ✔ | ✔ | (✔) | |||
| หมายเลขตอน | ✔ | ||||||
| ชื่อตอน | (✔) | ||||||
| ประเภท | (✔) | (✔) | (✔) | (✔) | |||
| Intent URI | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| จำนวนการโต้ตอบ | (✔) | (✔) | |||||
| ประเภทการโต้ตอบ | (✔) | (✔) | |||||
| รหัสผู้ให้บริการภายใน | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| จำนวนรายการ | (✔) | (✔) | |||||
| ไลฟ์สด | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| URI ของโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| คำอธิบายเนื้อหาโลโก้ (*) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| ราคาเสนอขาย | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| สัดส่วนภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI ของภาพโปสเตอร์ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ | ✔ |
| URI ของวิดีโอตัวอย่าง | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| Release Date | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | |
| คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| รูปแบบการให้คะแนนรีวิว | (✔) | (✔) | (✔) | (✔) | (✔) | ||
| หมายเลขซีซันที่แสดง | ✔ | ✔ | |||||
| คำอธิบายแบบสั้น | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) | (✔) |
| เวลาเริ่มต้นเป็นมิลลิวินาทีตามเวลา UTC (*) | ✔ | ✔ | ✔ | ✔ | |||
| เวลาสิ้นสุดเป็นมิลลิวินาทีตามเขตเวลา 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