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

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

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

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

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

หน้าจอหลักจะแสดงวิดีโอแนะนำ 2 วิธีที่แตกต่างกัน โดยขึ้นอยู่กับเวอร์ชันของ Android ดังนี้

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

แอปของคุณควรใช้ API คำแนะนำทั้ง 2 รายการเพื่อให้แสดงคำแนะนำใน 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.
}

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

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