คุณภาพแอปสำหรับทีวี

แอปแสดงไอคอน Launcher ใน Android TV Launcher หลังการติดตั้ง ดูข้อมูลเพิ่มเติมได้ที่ ประกาศกิจกรรมทางทีวี

แอปจะแสดงทั้งแบนเนอร์ขนาดเต็ม 320x180 พิกเซลและไอคอนแอปขนาดอย่างน้อย 160x160 พิกเซล (ที่ความหนาแน่น xhdpi) เป็นไอคอน Launcher ใน Android TV Launcher ดูข้อมูลเพิ่มเติมได้ที่ หลักเกณฑ์เกี่ยวกับไอคอนแอปและแบนเนอร์ของ Android TV

แบนเนอร์เปิดตัวแอปมีชื่อแอป

หากเป็นแอปเกม แอปจะปรากฏในแถวเกมใน Android TV Launcher
ดูข้อมูลเพิ่มเติมได้ที่ แสดงเกมบนหน้าจอหลัก

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

อินเทอร์เฟซของแอปทั้งหมดจะแสดงในแนวนอนและไม่มีแถบดำด้านบน/ด้านล่าง หรือด้านข้าง ใช้ได้เฉพาะสีดำสำหรับแถบในวิดีโอรูปแบบต้นฉบับ ดูข้อมูลเพิ่มเติมได้ที่ สร้างเลย์เอาต์ทีวีพื้นฐาน

แอปไม่แสดงข้อความหรือฟังก์ชันการทำงานที่ถูกขอบหน้าจอตัดออกบางส่วน ดูข้อมูลเพิ่มเติมได้ที่ การสแกนเกิน

แอปไม่ได้บดบังแอปอื่นๆ บางส่วน แอปจะแสดงเต็มหน้าจอและมี พื้นหลังที่ไม่โปร่งใส

ฟังก์ชันการทำงานของแอปจะไปยังส่วนต่างๆ ได้โดยใช้ตัวควบคุม D-pad แบบ 5 ทิศทาง เว้นแต่แอป ต้องใช้ตัวควบคุมเกม ตามที่ระบุไว้ในเกณฑ์ TV-GP ในส่วนตัวควบคุมของตารางฟังก์ชันการทำงานที่ตามมา ดูข้อมูลเพิ่มเติมได้ที่ การนำทางบนทีวี

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

แอปไม่จำเป็นต้องใช้อุปกรณ์รีโมตคอนโทรลที่มีปุ่มเมนูเพื่อเข้าถึงการควบคุมอินเทอร์เฟซผู้ใช้

การกดปุ่มย้อนกลับจะนำคุณกลับไปที่หน้าจอหลักของ Android TV ดูข้อมูลเพิ่มเติมได้ที่ กำหนดลักษณะการทำงานของปุ่มย้อนกลับที่เหมาะสม

หากแอปมีฟีดทีวีสดที่ผสานรวมอยู่ในแท็บสด แสดงว่าแอปเป็นไปตามข้อกำหนดในการเล่นแบบราบรื่นและการกลับไปที่แอปโดยตรง ดูข้อมูลเพิ่มเติมได้ที่ ปุ่มย้อนกลับ

คำค้นหาในแอปจะปรากฏในช่องค้นหา ซึ่งคล้ายกับอินเทอร์เฟซผู้ใช้ที่ SearchFragment จัดให้ และผลการค้นหาจะเกี่ยวข้องกับคำค้นหานั้น ดูข้อมูลเพิ่มเติมได้ที่ ค้นหาภายในแอปทีวี

ไฟล์ Manifest ของแอปตั้งค่าประเภท Intent ของ ACTION_MAIN ไว้เป็นหมวดหมู่ CATEGORY_LEANBACK_LAUNCHER ดูข้อมูลเพิ่มเติมได้ที่ ประกาศกิจกรรมทางทีวี

ไฟล์ Manifest ของแอปตั้งค่าฟีเจอร์ฮาร์ดแวร์ android.hardware.touchscreen และ อื่นๆ ที่ระบุไว้ใน "ประกาศข้อกำหนดด้านฮาร์ดแวร์สำหรับทีวี" เป็นไม่บังคับ ดูข้อมูลเพิ่มเติมได้ที่ ประกาศข้อกำหนดของฮาร์ดแวร์สำหรับทีวี

หากแอปใช้เกมคอนโทรลเลอร์เป็นวิธีการป้อนข้อมูลหลัก แอปจะประกาศข้อกำหนดที่เหมาะสมด้วยแท็ก <uses-feature> ในไฟล์ Manifest ดูข้อมูลเพิ่มเติมได้ที่ ประกาศการรองรับเกมคอนโทรลเลอร์

หากแอปมีวิธีการแบบภาพสำหรับการใช้เกมคอนโทรลเลอร์ วิธีการดังกล่าวจะ ไม่มีการสร้างแบรนด์และแสดงเลย์เอาต์ปุ่มที่เข้ากันได้ ดูข้อมูลเพิ่มเติมได้ที่ จัดการคอนโทรลเลอร์สำหรับเกม

แอปมีการโต้ตอบกับโฆษณาโดยใช้การควบคุม D-pad ดูข้อมูลเพิ่มเติมได้ที่ เปิดใช้การนำทางด้วย D-pad

สําหรับการโฆษณาที่ใช้โฆษณาแบบเต็มหน้าจอที่ไม่ใช่วิดีโอ แอปจะอนุญาตให้ผู้ใช้ ปิดโฆษณาทันทีด้วยตัวควบคุม D-pad หรือเกมแพด

สำหรับการโฆษณาที่ใช้โฆษณาที่ไม่ใช่วิดีโอแบบคลิกได้และไม่ใช่แบบเต็มหน้าจอ แอป จะไม่อนุญาตให้โฆษณาลิงก์ไปยัง URL ของเว็บ

สำหรับการโฆษณาที่ใช้โฆษณาแบบคลิกได้ ไม่ใช่แบบเต็มหน้าจอ และไม่ใช่แบบวิดีโอ แอป ไม่อนุญาตให้โฆษณาลิงก์ไปยังแอปอื่นที่ไม่ได้ให้บริการในอุปกรณ์ทีวี

สำหรับเนื้อหาเว็บ แอปอาจใช้ได้เฉพาะ WebView คอมโพเนนต์ แอป ต้องไม่พยายามเปิดแอปเว็บเบราว์เซอร์

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

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

หากแอปมีการ์ดกำลังเล่น การเลือกการ์ดนี้จะนำผู้ใช้ไปยัง หน้าจอที่ให้ผู้ใช้หยุดการเล่นชั่วคราว

หากแอปเล่นเนื้อหาวิดีโอหรือเพลง แอปจะสลับระหว่างการเล่นและ หยุดเล่นสื่อชั่วคราว เมื่อมีการส่งเหตุการณ์คีย์เล่นหรือหยุดชั่วคราวระหว่างการเล่น ดูข้อมูลเพิ่มเติมได้ที่ KEYCODE_MEDIA_PLAY_PAUSE

ขณะที่วิดีโอหรือเสียงกำลังเล่น การกดปุ่มตรงกลางของ D-pad จะหยุดสื่อที่กำลังเล่นชั่วคราว เมื่อหยุดเล่นชั่วคราว การกดปุ่มตรงกลางของ D-pad จะกลับมาเล่นต่อ ปุ่มซ้าย และขวาของ D-pad จะกรอไปข้างหน้าและกรอกลับแทร็กปัจจุบันตามลำดับ ดูข้อมูลเพิ่มเติมได้ที่ เหตุการณ์สื่อ

ระบบจะเพิ่มรายการลงในช่องฟีดวิดีโอถัดไปตาม หลักเกณฑ์ฟีดวิดีโอถัดไป สำหรับนักพัฒนาแอป

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

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

สำหรับการเล่นเฉพาะเสียง แอปจะไม่ป้องกันไม่ให้อุปกรณ์เข้าสู่โหมดแอมเบียนท์ เว้นแต่แอปจะใช้ประสบการณ์การใช้งานภาพที่ไม่ใช่ภาพนิ่ง เช่น มิวสิกวิดีโอหรือรูปภาพ ขณะที่เล่นเพลง

สำหรับอุปกรณ์ที่มี RAM น้อย (ซึ่ง ActivityManager.isLowRamDevice() แสดงผลเป็นจริง) การใช้หน่วยความจำสูงสุด ( Anon+Swap + Graphics + File Memory) ของแอปที่ทำงานอยู่เบื้องหน้าต้อง อยู่ภายในขีดจำกัด (รวมถึงกลไกการวัดผลและข้อควรระวังที่เฉพาะเจาะจง) ที่กำหนดไว้ใน เพิ่มประสิทธิภาพการใช้หน่วยความจำ

แอปจะตั้งค่าข้อมูลเมตาที่เหมาะสมเพื่อจัดหมวดหมู่การใช้งานโหมดภาพซ้อนภาพเป็นประเภทการใช้งานที่ได้รับอนุญาตประเภทใดประเภทหนึ่ง นอกจากนี้ยังประกาศชื่อและคำบรรยายแทนเสียงที่แสดงถึงสิ่งที่ กำลังใช้ PIP นี้อย่างถูกต้อง

ดูข้อมูลเพิ่มเติมได้ที่ การทำงานหลายอย่างพร้อมกันบนทีวี

ขณะอยู่ในโหมดภาพซ้อนภาพ แอปจะไม่แสดงสื่อส่งเสริมการขายหรือโฆษณาที่ ไม่ได้เป็นส่วนหนึ่งของแหล่งที่มาของเนื้อหาโดยธรรมชาติ

ขณะอยู่ในโหมดการแสดงภาพซ้อนภาพ แอปจะไม่ลดคุณภาพประสบการณ์การใช้งานกิจกรรมแบบเต็มหน้าจออื่น

แอปไม่ควรใช้ทรัพยากรมากเกินไป เข้าควบคุมโฟกัสเสียง รบกวน MediaSession ที่ใช้งานอยู่ หรือขอเซสชันตัวถอดรหัสจำนวนมากเกินไป

แอปไม่แสดงตัวควบคุม UI หรือองค์ประกอบที่ไปยังส่วนต่างๆ ได้ขณะอยู่ในโหมดการแสดงภาพซ้อนภาพ แอปอาจแสดงการควบคุมของผู้ใช้บางอย่างในหน้าต่าง PIP โดยตรง

การเข้าสู่โหมดภาพซ้อนภาพต้องมีการดำเนินการที่ชัดเจนและตั้งใจของผู้ใช้ภายใน แอป แอปจะไม่เข้าสู่โหมด PiP โดยอัตโนมัติ (setAutoEnterEnabled ตั้งค่าเป็น false) เว้นแต่ผู้ใช้จะอยู่ในสายที่กำลังดำเนินการอยู่

แอปต้องไม่แสดง UI เพื่อเข้าสู่ PIP หากโหมดการแสดงภาพซ้อนภาพ ปิดใช้ในอุปกรณ์

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

การใช้ Android App Bundle เป็นข้อบังคับสำหรับแอป TV ใหม่และแอป TV ที่มีอยู่ทั้งหมดใน Google Play Store

แอปของคุณต้องเป็นไปตามข้อกำหนดของศูนย์นโยบายสำหรับนักพัฒนาแอป Play

ฟังก์ชันการทำงานของแอปเป็นไปตามที่คาดไว้หรือตามที่อธิบายไว้ในข้อมูลแอปใน Google Play Store

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

สำหรับแอปที่มีฟีเจอร์แบบชำระเงิน คุณต้องระบุข้อมูลเข้าสู่ระบบใน Google Play Console เพื่อ ทดสอบประสบการณ์การใช้งานแอปแบบเต็ม ดูข้อมูลเพิ่มเติมได้ที่ แอป เข้าถึงในเตรียมแอปสำหรับการตรวจสอบ