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

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

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

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

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

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

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

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

Kotlin

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

Java

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 ใหม่เป็นครั้งแรก กรณีนี้จะเกิดขึ้นทันทีหากแอปสร้าง แชแนลเริ่มต้น หรือภายหลังเมื่อผู้ใช้เลือกและเพิ่มช่องอื่นๆ ที่แอปของคุณสร้างขึ้น