Android TV ที่มี Google Cast

ในการเปิดตัว Android 5.0 มาพร้อมกับ Android TV ซึ่งรองรับ Google Cast เอกสารนี้อธิบายสิ่งที่คุณต้องทำเพื่อตั้งค่าและทดสอบใน Android TV เมื่อพัฒนาแอปพลิเคชัน Cast แอปพลิเคชัน Cast ที่คุณมีอยู่ทำงานบน Android TV ได้โดยไม่ต้องทำอะไรเพิ่มเติม หากคุณกำลังพัฒนาแอปพลิเคชัน Cast เป็นครั้งแรก โปรดอ่านเอกสารประกอบของ Google Cast และพัฒนาแอปพลิเคชัน Cast ให้ทำงานในอุปกรณ์ Chromecast ก่อนที่จะพัฒนาและทดสอบกับ Android TV

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

การตั้งค่าเพื่อการพัฒนา

1. ตั้งค่าอุปกรณ์ Android TV
   1. เชื่อมต่ออุปกรณ์ Android TV กับเครือข่ายภายใน
   2. ลงชื่อเข้าใช้บัญชี Google
2. จากการตั้งค่า ในแถวอุปกรณ์ ให้เลือกเกี่ยวกับ
3. เลื่อนลงไปแล้วคลิก Build หลายๆ ครั้งจนกว่ากล่องโต้ตอบจะปรากฏขึ้นพร้อมข้อความว่า "คุณเป็นนักพัฒนาซอฟต์แวร์แล้ว"
4. หากแก้ไขข้อบกพร่องผ่าน USB ให้ทำดังนี้
   1. ติดตั้งสาย USB แต่อย่าเพิ่งเชื่อมต่อส่วนปลายของสาย USB กับคอมพิวเตอร์
   2. ในแถวค่ากำหนด ให้เลือกตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ เลือกการแก้ไขข้อบกพร่อง USB แล้วเลือกเปิด
5. กลับไปที่หน้าจอหลัก คุณต้องทำแบบนี้เพื่อใช้ การตั้งค่าที่เพิ่งเลือกไป การตั้งค่าจะยังคงอยู่จนกว่าคุณจะรีเซ็ตเป็นค่าเริ่มต้น
6. ลงทะเบียนอุปกรณ์ Android TV ใน แผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์ Google Cast SDK ตามที่อธิบายไว้ในการลงทะเบียนอุปกรณ์

การแก้ไขข้อบกพร่อง

หากต้องการทดสอบและแก้ไขข้อบกพร่องของแอปพลิเคชัน Web Receiver บนอุปกรณ์ Android TV ให้ดำเนินการดังนี้

1. ลงทะเบียนอุปกรณ์ Android TV และแอปพลิเคชันใน แผงควบคุมสำหรับนักพัฒนาซอฟต์แวร์ Google Cast SDK ดูข้อมูลเพิ่มเติมเกี่ยวกับการลงทะเบียนอุปกรณ์และแอปพลิเคชันได้ที่การลงทะเบียน
2. เริ่มแอปพลิเคชันผู้ส่งและแคสต์ไปยังอุปกรณ์ Android TV
3. เชื่อมต่ออุปกรณ์ Android TV ผ่าน ADB ตามที่อธิบายไว้ในการใช้ Android Debug Bridge
4. ในเครื่องการพัฒนา ให้เปิดหน้าต่างเบราว์เซอร์ Chrome แล้วไปที่ chrome://inspect
   หมายเหตุ: วิธีนี้ต่างจาก ตัวเลือกการแก้ไขข้อบกพร่องสำหรับอุปกรณ์ Chromecast ที่ให้คุณไปยังที่อยู่ IP ของตัวรับสัญญาณเว็บบนพอร์ต 9222
5. คลิกลิงก์inspectเพื่อนำเว็บรีซีฟเวอร์ลงในโปรแกรมแก้ไขข้อบกพร่อง

6. ในคอนโซลโปรแกรมแก้ไขข้อบกพร่องระยะไกลของ 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 ให้ทำดังนี้

1. ในอุปกรณ์ Android TV เปิดใช้ตัวเลือกสำหรับนักพัฒนาซอฟต์แวร์ตามที่อธิบายไว้ในการตั้งค่าเพื่อการพัฒนา
2. ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อกับเครือข่ายเดียวกันกับอุปกรณ์ Android TV

3. เปิดเทอร์มินัลและป้อนข้อมูลต่อไปนี้

   adb connect Android TV device IP address:4321
   

4. ในคอมพิวเตอร์ ให้เปิดเทอร์มินัลแล้วป้อนคำสั่ง ADB คุณสามารถยืนยันว่ามีการเชื่อมต่อแล้วและอุปกรณ์ Android TV กำลังสื่อสารข้ามเครือข่ายโดยใช้คำสั่งต่อไปนี้

   adb logcat

การใช้ ADB ด้วยสาย USB

หากต้องการเชื่อมต่ออุปกรณ์ผ่าน ADB ด้วยการเชื่อมต่อสาย USB ให้ทำดังนี้

1. ตั้งค่าอุปกรณ์ Android TV สำหรับการพัฒนาตามที่อธิบายไว้ในการตั้งค่าเพื่อการพัฒนา
2. เชื่อมต่อปลายสาย USB เข้ากับคอมพิวเตอร์
3. ในกล่องโต้ตอบอนุญาตให้แก้ไขข้อบกพร่อง USB ไหม ให้เลือกอนุญาตเสมอจากคอมพิวเตอร์เครื่องนี้ แล้วเลือกตกลง

4. ในคอมพิวเตอร์ ให้เปิดเทอร์มินัลแล้วป้อนคำสั่ง ADB คุณสามารถยืนยันว่ามีการเชื่อมต่อแล้วและอุปกรณ์ Android TV กำลังสื่อสารข้ามเครือข่ายโดยใช้คำสั่งต่อไปนี้

   adb logcat

การใช้ ADB ผ่าน TCP/IP

ADB ทำงานได้โดยไม่ต้องใช้สาย USB ผ่าน TCP/IP แต่คุณต้องได้ที่อยู่ IP ของอุปกรณ์ Android TV ก่อน อุปกรณ์ที่เกิดปัญหาของนักพัฒนาซอฟต์แวร์จะคอยตรวจจับการเชื่อมต่อพอร์ต ADB โดยอัตโนมัติและสามารถเชื่อมต่อได้โดยไม่ต้องเริ่มต้นพอร์ต อุปกรณ์ Android TV แบบมาตรฐานจะไม่คอยฟังการเชื่อมต่อ ADB โดยอัตโนมัติ สำหรับอุปกรณ์เหล่านี้ คุณต้องเชื่อมต่อกับ ADB ด้วยสาย USB ก่อน แล้วจึงเริ่มต้นพอร์ต

1. ตั้งค่าอุปกรณ์ Android TV สำหรับการพัฒนาตามที่อธิบายไว้ในการตั้งค่าเพื่อการพัฒนา
2. ใน Android TV ในแถวอุปกรณ์ ให้เลือกเครือข่าย > Wi-Fi แล้วเลือกเครือข่ายที่เชื่อมต่อ
3. เลือกข้อมูลสถานะ และจดบันทึกที่อยู่ IP

4. หากอุปกรณ์ของคุณเป็นอุปกรณ์มาตรฐานที่จำหน่ายอุปกรณ์ Android TV ให้ทำตามขั้นตอนต่อไปนี้

   1. ทำตามขั้นตอนภายใต้การใช้ ADB ด้วยสาย USB
   2. ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อกับเครือข่ายเดียวกันกับอุปกรณ์ Android TV

   3. ในคอมพิวเตอร์ ให้เริ่มต้นพอร์ตสำหรับ TCP/IP โดยป้อนข้อมูลต่อไปนี้

      adb tcpip 5555

   4. ถอดสาย USB ออกแล้วป้อนข้อมูลต่อไปนี้ในเทอร์มินัล

      adb connect Android TV device IP address:5555
      

5. หากอุปกรณ์เป็น Android TV ที่นักพัฒนาแอปมีปัญหา ให้ทําตามขั้นตอนต่อไปนี้

   1. ตรวจสอบว่าคอมพิวเตอร์เชื่อมต่อกับเครือข่ายเดียวกับอุปกรณ์ Android TV

   2. เปิดเทอร์มินัลและป้อนข้อมูลต่อไปนี้

      adb connect Android TV device IP address:4321
      

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

   adb logcat