แอตทริบิวต์โปรแกรมวิดีโอ

แอตทริบิวต์ของโปรแกรมวิดีโอจะขึ้นอยู่กับประเภทของเนื้อหา ประเภทโปรแกรม บอกให้ระบบทราบถึงข้อมูลเมตาที่ต้องการเพื่อให้ใส่ 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