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

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

แอปแสดงทั้งแบนเนอร์ขนาดเต็ม 320x180 พิกเซลและไอคอนแอปขนาดอย่างน้อย 160x160 พิกเซล (ที่ความหนาแน่น xhdpi) เป็นไอคอน Launcher ในแอป Launcher ของ Android TV ดูข้อมูลเพิ่มเติมได้ที่ หลักเกณฑ์เกี่ยวกับไอคอนและแบนเนอร์แอป 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 และฟีเจอร์อื่นๆ ที่ระบุไว้ใน "ประกาศข้อกำหนดด้านฮาร์ดแวร์สำหรับทีวี" เป็นไม่บังคับ ดูข้อมูลเพิ่มเติมได้ที่ประกาศข้อกำหนดด้านฮาร์ดแวร์สำหรับทีวี

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

แอปทีวีใหม่และแอปทีวีที่มีอยู่ทั้งหมดใน Google Play Store ต้องใช้ Android App Bundle

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

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

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

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