Android 5.0 sürümüyle birlikte Google Cast'i destekleyen Android TV de geliyor. Bu dokümanda, Cast uygulamaları geliştirirken Android TV'yi kurmak ve test etmek için yapmanız gerekenler açıklanmaktadır. Mevcut Cast uygulamanız hiçbir ek işlem gerektirmeden Android TV'de çalışır. İlk kez bir Cast uygulaması geliştiriyorsanız Google Cast dokümanlarını inceleyin ve Android TV ile geliştirmeden ve test etmeden önce Cast uygulamanızı bir Chromecast cihazda çalışacak şekilde geliştirin.
Geliştirme için hazırlık
- Android TV cihazınızı kurun:
- Android TV cihazını yerel ağa bağlayın.
- Google hesabınızda oturum açın.
- Ayarlar bölümündeki Cihaz satırında Hakkında'yı seçin.
- Aşağı kaydırın ve "Artık bir geliştiricisiniz" mesajını içeren bir iletişim kutusu görünene kadar Derleme'yi birkaç kez tıklayın.
- USB üzerinden hata ayıklama:
- USB kablosunu takın ancak USB kablosunun ana ucunu henüz bilgisayarınıza bağlamayın.
- Tercihler satırında Geliştirici seçenekleri'ni, USB üzerinden hata ayıklama'yı ve Açık'ı seçin.
- Ana ekrana geri dönün. Az önce seçtiğiniz ayarları uygulamak için bunu yapmanız gerekir. Fabrika ayarlarına sıfırlamadığınız sürece ayarlar değişmeden kalır.
- Android TV cihazınızı Cihaz Kaydı konusunda açıklandığı şekilde Google Cast SDK Geliştirici Konsolu'na kaydedin.
Hata ayıklama
Web Alıcısı uygulamanızı Android TV cihazınızda test etmek ve hata ayıklamak için aşağıdakileri yapın:
- Android TV cihazınızı ve uygulamanızı Google Cast SDK Geliştirici Konsolu'na kaydedin. Cihazları ve uygulamaları kaydetme hakkında daha fazla bilgi için Kayıt bölümüne bakın.
- Gönderen uygulamanızı başlatın ve Android TV cihazınıza yayınlayın.
- Android Debug Bridge'i kullanma bölümünde açıklandığı gibi, Android TV cihazınıza ADB üzerinden bağlanın.
- Geliştirme makinenizde bir Chrome tarayıcı penceresi açın ve chrome://inspect adresine gidin.
- Web Alıcısı'nı hata ayıklayıcıya getirmek için inspect (incele) bağlantısını tıklayın.
Chrome Uzaktan Hata Ayıklayıcı Konsolu'nda, aşağıdakileri girerek hata ayıklama günlük kaydını etkinleştirin:
cast.receiver.logger.setLevelValue(cast.receiver.LoggerLevel.DEBUG);
Daha fazla bilgi için Hata ayıklama bölümünü inceleyin.
Android TV uyumluluğu ile ilgili yönergeler
Cast uygulamanızı Android TV ile uyumlu hale getirmek için çok az ek işlem yapmanız gerekir. Aşağıda, uygulamanızın Android TV ile uyumlu olmasını sağlamak için kaçınmanız gereken bazı öneriler ve yaygın görülen tuzaklar verilmiştir:
- Kullanıcı aracısı dizesinin hem "Android" hem de "CrKey"i içerdiğini unutmayın. Bazı siteler "Android" etiketini algıladığı için yalnızca mobil cihazlara yönelik bir siteye yönlendirme yapabilir. Kullanıcı aracısı dizesindeki "Android"in her zaman bir mobil kullanıcıyı belirttiğini varsaymayın.
- Android'in medya yığını, verileri getirmek için şeffaf GZIP kullanabilir. Medya verilerinizin
Accept-Encoding: gzipözelliğine yanıt verebildiğinden emin olun. - Android TV HTML5 medya etkinlikleri Chromecast'ten farklı zamanlamalarda tetiklenebilir. Bu durum, Chromecast'te gizlenmiş sorunların ortaya çıkmasına neden olabilir.
- Medyayı güncellerken
timeupdate,pausevewaitinggibi<audio>/<video>öğeleri tarafından tetiklenen medyayla ilgili etkinlikleri kullanın.progress,suspendvestalledgibi ağla ilgili etkinlikler kullanmaktan kaçının. Bunlar genellikle platforma bağlıdır. - Web Alıcısı sitenizin HTTPS sertifikalarını yapılandırırken ara CA sertifikalarını eklediğinizden emin olun. Doğrulamak için Qualsys SSL test sayfasına bakın: Sitenizin güvenilir sertifika yolunda "extra download" etiketli bir CA sertifikası varsa bu sertifika Android tabanlı platformlarda yüklenmeyebilir.
- Chromecast, Web Alıcısı sayfasını 720p grafik düzleminde görüntülerken, Android TV dahil diğer Cast platformları sayfayı 1080p çözünürlüğe kadar görüntüleyebilir. Web Alıcı sayfanızın farklı çözünürlüklerde sorunsuz bir şekilde ölçeklendirildiğinden emin olun.
Android Debug Bridge'i kullanma
Android TV platformu; televizyonlar, set üstü kutular, oyun konsolları gibi pek çok tüketici elektroniği cihazında yer alıyor. Her biri farklı şekilde yapılandırılabilir. Android TV sistem kaynaklarına cihazın kullanıcı arayüzü üzerinden erişme konusunda zorluk yaşıyorsanız Android Debug Bridge'i (ADB) kullanarak kayıt amacıyla cihazınızın seri numarasını alabilir ve uygulamanızdaki hataları ayıklayabilirsiniz. Daha fazla bilgi için Android Hata Ayıklama Köprüsü bölümüne bakın.
Kablosuz ağ üzerinden ADB kullanma
Kablosuz bağlantıyla ADB üzerinden cihazınıza bağlanmak için:
- Android TV cihazınızda, Geliştirme için ayarlama bölümündeki talimatları izleyerek geliştirici seçeneklerini etkinleştirin.
- Bilgisayarınızın Android TV cihazınızla aynı ağa bağlı olduğundan emin olun.
Bir terminal penceresi açın ve aşağıdaki kodu girin:
adb connect Android TV device IP address:4321
Bilgisayarınızda bir terminal penceresi açın ve ADB komutlarını girin. Aşağıdaki komutla bağlantının kurulduğunu ve Android TV cihazının ağ genelinde iletişim kurduğunu doğrulayabilirsiniz:
adb logcat
USB kablosuyla ADB kullanma
Cihazınıza USB kablo bağlantısıyla ADB üzerinden bağlanmak için:
- Android TV cihazınızı geliştirme için ayarlayın (Geliştirme için ayarlama bölümünde açıklandığı gibi).
- USB kablosunun ana ucunu bilgisayarınıza bağlayın.
- USB hata ayıklamasına izin verilsin mi? iletişim kutusunda, Her zaman bu bilgisayardan izin ver'i ve ardından Tamam'ı seçin.
Bilgisayarınızda bir terminal penceresi açın ve ADB komutlarını girin. Aşağıdaki komutla bağlantının kurulduğunu ve Android TV cihazının ağ genelinde iletişim kurduğunu doğrulayabilirsiniz:
adb logcat
TCP/IP üzerinden ADB kullanma
ADB, USB kablosu olmadan TCP/IP üzerinden çalışır, ancak önce Android TV cihazının IP adresini almanız gerekir. Geliştirici sorunları, ADB bağlantı noktası bağlantılarını otomatik olarak dinler ve bağlantı noktasını başlatmadan bağlanabilir. Standart perakende Android TV cihazları, ADB bağlantılarını otomatik olarak dinlemez. Bu cihazlar için önce ADB'ye bir USB kablosuyla bağlanmanız ve bağlantı noktasını başlatmanız gerekir.
- Android TV cihazınızı geliştirme için ayarlayın (Geliştirme için ayarlama bölümünde açıklandığı gibi).
- Android TV'deki Cihaz satırında Ağ > Kablosuz'u ve ardından bağlı ağı seçin.
- Durum bilgileri'ni seçin ve IP adresini not edin.
Cihazınız standart, perakende bir Android TV cihazıysa aşağıdakileri yapın:
- ADB'yi USB kablosuyla kullanma bölümündeki adımları uygulayın.
- Bilgisayarınızın Android TV cihazıyla aynı ağa bağlı olduğundan emin olun.
Bilgisayarınızda, bir terminalde aşağıdakileri girerek TCP/IP bağlantı noktasını başlatın:
adb tcpip 5555
USB kablosunu çıkarın ve terminale aşağıdaki bilgileri girin:
adb connect Android TV device IP address:5555
Cihazınızda geliştiricinin sorunları olan bir Android TV varsa aşağıdakileri yapın:
- Bilgisayarınızın Android TV cihazınızla aynı ağa bağlı olduğundan emin olun.
Bir terminal penceresi açın ve aşağıdaki kodu girin:
adb connect Android TV device IP address:4321
Android TV'deki USB hata ayıklamasına izin verilsin mi? iletişim kutusunda, Bu bilgisayardan her zaman izin ver'i seçip Tamam'ı seçin. Aşağıdaki komutla bağlantının kurulduğunu ve Android TV cihazının ağ üzerinde iletişim kurduğunu doğrulayabilirsiniz:
adb logcat