การเปิดตัว Android 5.0 มาพร้อมกับ Android TV ซึ่งรองรับ Google Cast เอกสารนี้อธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าและทดสอบใน Android TV เมื่อพัฒนาแอปพลิเคชัน Cast แอปพลิเคชัน Cast ที่ใช้งานอยู่ ใช้งาน Android TV ได้ง่ายๆ หากคุณกำลังพัฒนาแอปพลิเคชัน Cast เป็นครั้งแรกโปรดอ่านเอกสารประกอบของ Google Cast และพัฒนาแอปพลิเคชัน Cast ให้ทำงานในอุปกรณ์ Chromecast ก่อน กำลังพัฒนาและทดสอบกับ Android TV
การตั้งค่าสำหรับการพัฒนา
- ตั้งค่าอุปกรณ์ Android TV
- เชื่อมต่ออุปกรณ์ Android TV กับเครือข่าย LAN
- ลงชื่อเข้าใช้บัญชี Google
- จากการตั้งค่า ในแถวอุปกรณ์ ให้เลือกเกี่ยวกับ
- เลื่อนลงไปและคลิกสร้างหลายๆ ครั้งจนกว่ากล่องโต้ตอบ จะปรากฏขึ้นพร้อมข้อความ "คุณเป็นนักพัฒนาซอฟต์แวร์แล้ว"
- หากการแก้ไขข้อบกพร่องผ่าน USB
- ติดตั้งสาย USB แต่ไม่ต้องเชื่อมต่อปลายหลักของสาย USB ในคอมพิวเตอร์ของคุณ
- ในแถวค่ากำหนด ให้เลือกตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ แล้วเลือก การแก้ไขข้อบกพร่อง USB แล้วเลือกเปิด
- กลับไปที่หน้าจอหลัก คุณต้องดำเนินการนี้เพื่อใช้การตั้งค่าที่คุณ ที่เพิ่งเลือกไว้ การตั้งค่าจะยังคงอยู่จนกว่าคุณจะรีเซ็ตเป็นค่าเริ่มต้น
- ลงทะเบียนอุปกรณ์ Android TV ใน Google Cast SDK Developer Console เป็น ตามที่อธิบายไว้ในการลงทะเบียนอุปกรณ์
การแก้ไขข้อบกพร่อง
ในการทดสอบและแก้ไขข้อบกพร่องแอปพลิเคชัน Web Receiver บนอุปกรณ์ Android TV ให้ทำ ดังต่อไปนี้:
- ลงทะเบียนอุปกรณ์ Android TV และแอปพลิเคชันของคุณใน Google Cast SDK Developer Console ดูการลงทะเบียนสำหรับข้อมูลเพิ่มเติมเกี่ยวกับ ลงทะเบียนอุปกรณ์และแอปพลิเคชัน
- เริ่มแอปพลิเคชันผู้ส่งและแคสต์ไปยังอุปกรณ์ Android TV
- เชื่อมต่อกับอุปกรณ์ Android TV ผ่าน ADB ตามที่อธิบายไว้ใน การใช้ Android Debug Bridge
- ในเครื่องพัฒนาซอฟต์แวร์ ให้เปิดหน้าต่างเบราว์เซอร์ Chrome แล้วไปที่ chrome://inspect
- คลิกลิงก์ตรวจสอบเพื่อนำตัวรับเว็บไปไว้ในโปรแกรมแก้ไขข้อบกพร่อง
ในคอนโซลเครื่องซ่อมแซมระยะไกลของ Chrome ให้เปิดใช้การบันทึกการแก้ไขข้อบกพร่องด้วยการป้อน ดังต่อไปนี้:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
โปรดดูข้อมูลเพิ่มเติมที่การแก้ไขข้อบกพร่อง
หลักเกณฑ์สำหรับความเข้ากันได้กับ Android TV
การทำให้แอปพลิเคชัน Cast ของคุณเข้ากันได้กับ Android TV นั้นทำได้น้อยมาก งานเพิ่มเติม ต่อไปนี้คือคำแนะนำและข้อผิดพลาดที่พบบ่อยที่คุณควรหลีกเลี่ยง วิธีตรวจสอบว่าแอปพลิเคชันของคุณเข้ากันได้กับ Android TV
- โปรดทราบว่าสตริง User Agent มีทั้งคำว่า "Android" และ "CrKey"; บางเว็บไซต์อาจเปลี่ยนเส้นทางไปยังเว็บไซต์ เฉพาะมือถือ เนื่องจากตรวจพบ "Android" ป้ายกำกับ อย่าคิดเอาเองว่า "Android" ในสตริง user-agent เสมอ แสดงถึงผู้ใช้อุปกรณ์เคลื่อนที่
- สแต็กสื่อของ Android อาจใช้ GZIP แบบโปร่งใสสำหรับการดึงข้อมูล ตรวจสอบว่า
ข้อมูลสื่อของคุณจะตอบสนองต่อ
Accept-Encoding: gzip
ได้ - ระบบอาจทริกเกอร์เหตุการณ์สื่อ HTML5 ของ Android TV ในช่วงเวลาที่ต่างจาก Chromecast อาจแสดงปัญหาที่ซ่อนอยู่ใน Chromecast
- เมื่ออัปเดตสื่อ ให้ใช้เหตุการณ์ที่เกี่ยวข้องกับสื่อที่เริ่มทำงานโดย
<audio>/<video>
องค์ประกอบ เช่นtimeupdate
,pause
และwaiting
หลีกเลี่ยงการใช้เหตุการณ์เกี่ยวกับเครือข่าย เช่นprogress
,suspend
และstalled
เนื่องจากมักขึ้นอยู่กับแพลตฟอร์ม - เมื่อกำหนดค่าใบรับรอง HTTPS ของเว็บไซต์ตัวรับสัญญาณเว็บ ให้ดำเนินการดังต่อไปนี้ รวมถึงใบรับรอง CA ระดับกลาง โปรดดู หน้าทดสอบ Qualsys SSL เพื่อ ยืนยัน: หากเส้นทางการรับรองที่เชื่อถือได้สำหรับเว็บไซต์ของคุณมี CA ใบรับรองที่มีป้ายกำกับว่า "ดาวน์โหลดเพิ่มเติม" ก็จะไม่สามารถโหลดบนระบบ Android ใหม่
- ในขณะที่ Chromecast แสดงหน้าตัวรับเว็บบนระนาบกราฟิก 720p แพลตฟอร์มการแคสต์อื่นๆ รวมถึง Android TV อาจแสดงหน้าเว็บได้สูงสุด 1080p ตรวจสอบให้แน่ใจว่าหน้าตัวรับเว็บปรับขนาดได้อย่างดีในความละเอียดต่างๆ
การใช้ Android Debug Bridge
แพลตฟอร์ม Android TV แสดงอยู่ในอุปกรณ์อิเล็กทรอนิกส์สำหรับผู้บริโภคหลายประเภท อุปกรณ์ ได้แก่ ทีวี กล่องรับสัญญาณ คอนโซลเกม และอื่นๆ แต่ละประเภทอาจมีการกำหนดค่าต่างกัน หากประสบปัญหาในการเข้าถึง คุณอาจทำสิ่งต่อไปนี้กับแหล่งข้อมูลระบบ Android TV ผ่านอินเทอร์เฟซผู้ใช้ของอุปกรณ์ได้ ใช้ Android Debug Bridge (ADB) เพื่อรับหมายเลขซีเรียลของอุปกรณ์สำหรับ รวมถึงเพื่อแก้ไขข้อบกพร่องของแอปพลิเคชัน โปรดดู Android Debug Bridge สำหรับข้อมูลเพิ่มเติม
การใช้ ADB ผ่าน Wi-Fi
วิธีเชื่อมต่อกับอุปกรณ์ผ่าน ADB ด้วยการเชื่อมต่อ Wi-Fi
- ในอุปกรณ์ Android TV ของคุณ ให้เปิดใช้ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ตามที่อธิบายไว้ใน การตั้งค่าสำหรับการพัฒนา
- ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อเครือข่ายเดียวกันกับ Android อุปกรณ์ทีวี
เปิดเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้
adb connect Android TV device IP address:4321
เปิดเทอร์มินัลแล้วป้อนคำสั่ง ADB ในคอมพิวเตอร์ คุณสามารถยืนยัน สร้างการเชื่อมต่อและอุปกรณ์ Android TV กำลังสื่อสาร ทั่วทั้งเครือข่ายด้วยคำสั่งต่อไปนี้
adb logcat
การใช้ ADB กับสาย USB
วิธีเชื่อมต่อกับอุปกรณ์ผ่าน ADB ด้วยการเชื่อมต่อสาย USB มีดังนี้
- ตั้งค่าอุปกรณ์ Android TV สำหรับการพัฒนาตามที่อธิบายไว้ใน การตั้งค่าสำหรับการพัฒนา
- เชื่อมต่อปลายหลักของสาย USB กับคอมพิวเตอร์
- ในกล่องโต้ตอบอนุญาตให้แก้ไขข้อบกพร่อง USB ไหม ให้เลือกอนุญาตทุกครั้งจาก คอมพิวเตอร์เครื่องนี้ แล้วเลือกตกลง
เปิดเทอร์มินัลแล้วป้อนคำสั่ง ADB ในคอมพิวเตอร์ คุณสามารถยืนยัน สร้างการเชื่อมต่อและอุปกรณ์ Android TV กำลังสื่อสาร ทั่วทั้งเครือข่ายด้วยคำสั่งต่อไปนี้
adb logcat
การใช้ ADB บน TCP/IP
ADB ทำงานโดยไม่ต้องใช้สาย USB บน TCP/IP แต่คุณต้องติดตั้ง Android ก่อน ที่อยู่ IP ของอุปกรณ์ทีวี อุปกรณ์ที่มีปัญหาของนักพัฒนาซอฟต์แวร์จะตรวจจับการเชื่อมต่อพอร์ต ADB โดยอัตโนมัติและสามารถเชื่อมต่อได้โดยไม่ต้องเริ่มต้นพอร์ต มาตรฐาน อุปกรณ์ Android TV ที่ขายปลีกจะไม่ตรวจจับการเชื่อมต่อ ADB โดยอัตโนมัติ สำหรับ อุปกรณ์เหล่านี้ คุณต้องเชื่อมต่อกับ ADB ด้วยสาย USB ก่อน และเริ่มต้น พอร์ต
- ตั้งค่าอุปกรณ์ Android TV สำหรับการพัฒนาตามที่อธิบายไว้ใน การตั้งค่าสำหรับการพัฒนา
- ใน Android TV ที่แถวอุปกรณ์ ให้เลือกเครือข่าย > Wi-Fi และเลือกเครือข่ายที่เชื่อมต่อ
- เลือกข้อมูลสถานะและจดบันทึกที่อยู่ IP
หากอุปกรณ์เป็นอุปกรณ์ Android TV มาตรฐานที่เป็นร้านค้าปลีก ให้ทำดังนี้
- ทำตามขั้นตอนใน การใช้ ADB กับสาย USB
- ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อกับเครือข่ายเดียวกันกับ Android อุปกรณ์ทีวี
ในคอมพิวเตอร์ ให้เริ่มต้นพอร์ตสำหรับ TCP/IP โดยใช้เทอร์มินัล ให้ป้อนข้อมูลต่อไปนี้
adb tcpip 5555
ถอดสาย USB ออกและป้อนข้อมูลต่อไปนี้ลงในขั้วปลายสายไฟ
adb connect Android TV device IP address:5555
หากอุปกรณ์ของคุณเป็น Android TV ที่นักพัฒนาแอปเป็นผู้ออก ให้ทำดังนี้
- ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อเครือข่ายเดียวกันกับ Android อุปกรณ์ทีวี
เปิดเทอร์มินัลแล้วป้อนข้อมูลต่อไปนี้
adb connect Android TV device IP address:4321
ใน Android TV ในกล่องโต้ตอบอนุญาตให้แก้ไขข้อบกพร่อง USB ไหม ให้เลือกทุกครั้ง อนุญาตจากคอมพิวเตอร์เครื่องนี้ แล้วเลือกตกลง คุณยืนยันการเชื่อมต่อได้ และอุปกรณ์ Android TV กำลังสื่อสารผ่าน เครือข่ายด้วยคำสั่งต่อไปนี้
adb logcat