แนะนำเนื้อหาในหน้าจอหลัก

หน้าจอหลักของ Android TV จะแสดงเนื้อหาที่แนะนำโดยใช้ ช่องและ โปรแกรม ช่องจะแสดงเป็นแถวแต่ละแถวในหน้าจอหลัก โดยมีการ์ดที่แสดงโปรแกรมทั้งหมดที่พร้อมใช้งานสำหรับช่องนั้นๆ

แอปควรมีช่องอย่างน้อย 1 ช่อง ช่องแรกที่ แอปสร้างขึ้นจะกลายเป็นช่องเริ่มต้น และ Android TV จะแสดงช่องดังกล่าวในหน้าจอหลักโดยอัตโนมัติ แอปสามารถเสนอช่องอื่นๆ ได้ แต่ผู้ใช้ต้องเลือกและอนุมัติช่องเหล่านั้นก่อนจึงจะเพิ่มลงในหน้าจอหลักได้

หากแอปของคุณมีรายการทีวี ภาพยนตร์ หรือเนื้อหาวิดีโออื่นๆ เราขอแนะนำให้คุณ รองรับการแสดงตัวอย่างวิดีโอและ ผสานรวมกับช่อง"ดูต่อ" ระบบ Android จะควบคุมช่อง "ดูต่อ" แอปของคุณสามารถเพิ่มโปรแกรมที่เกี่ยวข้องกับผู้ใช้ลงในช่องนี้ได้ เช่น โปรแกรมที่ผู้ใช้ทำเครื่องหมายว่าน่าสนใจ หยุดดูกลางคัน หรือเกี่ยวข้องกับเนื้อหาที่ผู้ใช้กำลังดูอยู่ (เช่น ตอนถัดไปในซีรีส์หรือซีซันถัดไปของรายการ)

ตรวจสอบความเข้ากันได้

หน้าจอหลักจะแสดงคำแนะนำ 2 วิธีที่แตกต่างกันไปตามเวอร์ชันของ Android ดังนี้

• ใน Android 8.0 (ระดับ API 26) ขึ้นไป แอปสามารถแสดงคำแนะนำในช่องอย่างน้อย 1 ช่องที่ปรากฏในแถวแยกกัน โดยช่องหนึ่ง (ช่องเริ่มต้น) จะปรากฏขึ้นเสมอ ผู้ใช้สามารถค้นพบและเพิ่มช่องอื่นๆ ลงในหน้าจอหลักได้ ดูวิธีสร้างช่องคำแนะนำ ในหน้าจอหลัก
• ก่อน Android 8.0, Android TV จะแสดงคำแนะนำทั้งหมดในแถวคำแนะนำเดียวที่ปรากฏบนหน้าจอเสมอ ดูวิธีสร้างแถวคำแนะนำ ในหน้าจอหลัก

แอปควรใช้ทั้ง API คำแนะนำเพื่อให้แสดงคำแนะนำใน Android TV ทุกเวอร์ชันได้ ทดสอบระดับ API ของระบบปัจจุบันและใช้ API ที่เหมาะสมเพื่อสร้างแถวหรือช่องคำแนะนำ

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

if (android.os.Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
  // Use the home screen recommendation channels API
} else {
  // Use the recommendations row API
}

หากคอมไพล์แอปโดยใช้ระดับ API 25 หรือต่ำกว่า แอปจะยังทำงานบน Android TV ในระดับ 26 ได้ ลักษณะการทำงานของคำแนะนำแบบเก่าเข้ากันได้กับเวอร์ชันใหม่ แต่มีข้อจำกัดดังนี้

• ระบบจะแปลงแถวคำแนะนำโดยอัตโนมัติและแสดงเป็นช่องใหม่ในหน้าจอหลัก
• โปรแกรมในช่องที่แปลงแล้วจะตอบสนองต่อการอัปเดตจาก บริการคำแนะนำ แต่ผู้ใช้ไม่สามารถใช้ UI ของทีวีเพื่อจัดการโปรแกรมในช่อง (เพิ่ม/นำโปรแกรมออก คัดลอกโปรแกรมไปยังช่อง "ดูต่อ")
• หากคุณอัปเดตแอปเป็นระดับ API 26 ช่องที่แปลงแล้วจะยังคงปรากฏในทีวีที่ใช้ระดับ API 26 ทีวีจะนำช่องที่แปลงแล้วออกจากหน้าจอในครั้งแรกที่แอปแสดงช่องที่สร้างด้วย API ใหม่ ซึ่งจะเกิดขึ้นทันทีหากแอปสร้าง ช่องเริ่มต้น หรือเกิดขึ้นในภายหลังเมื่อผู้ใช้เลือกและเพิ่มช่องอื่นๆ ที่แอปสร้างขึ้น