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

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