Android 5.0 sürümüyle birlikte Google Cast'i destekleyen Android TV gelir. Bu dokümanda, Cast uygulamaları geliştirirken Android TV'yi kurmak ve test etmek için yapmanız gerekenler açıklanmaktadır. Mevcut Yayın uygulamanız ek bir çaba sarf etmeden Android TV'de çalışır. İlk kez bir Cast uygulaması geliştiriyorsanız Google Cast belgelerini inceleyin ve Android TV ile geliştirip test etmeden önce Cast uygulamanızı Chromecast cihazda çalışacak şekilde geliştirin.
Geliştirme için ayarlanıyor
- 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ünde, Cihaz satırında Hakkında'yı seçin.
- Aşağı kaydırın ve "Artık bir geliştirici oldunuz." mesajının göründüğü bir iletişim kutusu görünene kadar Oluştur'u birkaç kez tıklayın.
- USB üzerinden hata ayıklama yapılıyorsa:
- 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. Bu işlemi az önce seçtiğiniz ayarları uygulamak için yapmanız gerekir. Fabrika ayarlarına sıfırlamadığınız sürece ayarlar aynı kalır.
- Android TV cihazınızı Cihaz Kaydı'nda açıklandığı şekilde Google Cast SDK Developer Console'a kaydedin.
Hata ayıklama
Android TV cihazınızda Web Alıcısı uygulamanızı test etmek ve hata ayıklamak için aşağıdakileri yapın:
- Android TV cihazınızı ve uygulamanızı Google Cast SDK Developer Console'a kaydedin. Cihazları ve uygulamaları kaydettirme hakkında daha fazla bilgi edinmek için Kayıt sayfasına bakın.
- Gönderen uygulamanızı başlatıp Android TV cihazına 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'e gidin.
- Web Alıcısı'nı hata ayıklayıcıya getirmek için inceleme bağlantısını tıklayın.
Chrome Uzaktan Hata Ayıklama Aracı konsolunda 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 kuralları
Cast uygulamanızı Android TV ile uyumlu hale getirmek için çok az ek çalışma gerekir. Uygulamanızın Android TV ile uyumlu olmasını sağlamak için kaçınmanız gereken bazı öneriler ve yaygın hatalar şunlardır:
- User-agent dizesinin hem "Android" hem de "CrKey" içerdiğini unutmayın; bazı siteler, "Android" etiketini tespit ettikleri için yalnızca mobil cihazlara yönelik bir siteye yönlendirme yapabilir. Kullanıcı aracısı dizesinde "Android"in her zaman bir mobil kullanıcı gösterdiğini belirtmeyin.
- 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 gizlenen sorunları ortaya çıkarabilir.
- Medyayı güncellerken
timeupdate,pausevewaitinggibi<audio>/<video>öğeleri tarafından tetiklenen medya ile ilgili etkinlikleri kullanın.progress,suspendvestalledgibi ağla ilgili etkinlikleri platforma bağımlı oldukları için kullanmaktan kaçının. - Web Alıcı sitenizin HTTPS sertifikalarını yapılandırırken ara CA sertifikaları eklediğinizden emin olun. Doğrulama için Qualsys SSL test sayfasına göz atın: Sitenizin güvenilir sertifika yolu "ek indirme" etiketli bir CA sertifikası içeriyorsa Android tabanlı platformlarda yüklenemeyebilir.
- Chromecast, Web Alıcı sayfasını 720p grafik düzleminde gösterirken Android TV dahil diğer Yayın platformları sayfayı 1080p'ye kadar görüntüleyebilir. Web Alıcı sayfanızın farklı çözünürlüklerde zarif bir şekilde ölçeklendiğinden emin olun.
Android Debug Bridge'i kullanma
Android TV platformu, televizyon, set üstü kutu, oyun konsolu vb. birçok tüketici elektroniği cihazında bulunur. Bunların her biri farklı şekilde yapılandırılabilir. Cihazın kullanıcı arayüzü aracılığıyla Android TV sistem kaynaklarına erişmede sorun yaşıyorsanız kayıt için cihazınızın seri numarasını almanın yanı sıra uygulamanızda hata ayıklamak üzere Android Hata Ayıklama Köprüsü'nü (ADB) kullanabilirsiniz. Daha fazla bilgi için Android Debug Bridge'e göz atın.
Kablosuz ağ üzerinden ADB kullanma
Kablosuz bağlantıyla cihazınıza ADB üzerinden bağlanmak için:
- Android TV cihazınızda Geliştirme için ayarlama bölümünde açıklandığı gibi geliştirici seçenekleri etkinleştirildi.
- Bilgisayarınız, Android TV cihazınızla aynı ağa bağlı olmalıdır.
Bir terminal penceresi açın ve aşağıdakileri 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 komutu kullanarak bağlantının kurulduğunu ve Android TV cihazının ağ genelinde iletişim kurduğunu doğrulayabilirsiniz:
adb logcat
ADB'yi USB kablosuyla kullanma
USB kablosuyla cihazınıza ADB üzerinden bağlanmak için:
- Android TV cihazınızı Geliştirme için ayarlama bölümünde açıklandığı gibi geliştirme için kurun.
- USB kablosunun ana ucunu bilgisayarınıza bağlayın.
- USB hata ayıklamasına izin verilsin mi? iletişim kutusunda, bu bilgisayardan Her zaman izin ver'i ve Tamam'ı seçin.
Bilgisayarınızda bir terminal penceresi açın ve ADB komutlarını girin. Aşağıdaki komutu kullanarak 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 kullanımı
ADB, TCP/IP üzerinden USB kablosu olmadan çalışır ancak öncelikle Android TV cihazının IP adresini almanız gerekir. Geliştirici sorunu olan cihazlar 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 öncelikle ADB'ye bir USB kablosuyla bağlamanız ve bağlantı noktasını başlatmanız gerekir.
- Android TV cihazınızı Geliştirme için ayarlama bölümünde açıklandığı gibi geliştirme için kurun.
- Android TV'nin Cihaz satırında Ağ > Kablosuz'u, ardından bağlı ağı seçin.
- Durum bilgileri'ni seçin ve IP adresini not edin.
Cihazınız standart bir perakende Android TV cihazıysa aşağıdakileri yapın:
- USB kablosuyla ADB kullanımı başlıklı makaledeki adımları uygulayın.
- Bilgisayarınız, Android TV cihazıyla aynı ağa bağlı olmalıdır.
Bilgisayarınızda, bir terminalde TCP/IP bağlantı noktasını başlatın. Aşağıdakileri girin:
adb tcpip 5555
USB kablosunu çıkarıp terminale aşağıdakileri girin:
adb connect Android TV device IP address:5555
Cihazınız geliştiriciyle ilgili bir Android TV ise aşağıdakileri yapın:
- Bilgisayarınız, Android TV cihazınızla aynı ağa bağlı olmalıdır.
Bir terminal penceresi açın ve aşağıdakileri girin:
adb connect Android TV device IP address:4321
Android TV'nin USB hata ayıklamasına izin verilsin mi? iletişim kutusunda Bu bilgisayardan her zaman izin ver'i ve Tamam'ı seçin. Aşağıdaki komutu kullanarak bağlantının kurulduğunu ve Android TV cihazının ağ genelinde iletişim kurduğunu doğrulayabilirsiniz:
adb logcat