iOS İzinleri ve Discovery

İşletim sistemi iOS 14'ten itibaren yeni kısıtlamaları zorunlu kılacak ve Cast kullanıcı deneyimini etkileyen izinler. Bu durum, iletişim kurma Cast SDK'sını uygulamanıza entegre edin. Uygulamanızın Cast işlevini sürdürebilmesi için iOS'in en son sürümlerine sahip olmanız, bu sürümlerin kullanılabilmesi için izin değişiklikleri.

iOS 14

Geliştiriciler, iOS Cast gönderen uygulamalarını Google Cast SDK'sına güncellemelidir. Sürüm 4.6.0 veya sonraki sürümler. Bu sürümler iOS 14 ve iOS sürümü için destek sağlar.

iOS 14'ten itibaren yerel ağdaki cihazları tarayan uygulamalar artık tek seferlik izin iletişim kutusuyla kullanıcılardan arayıp bağlanacak yerel ağ cihazları için geçerlidir. Cast platformu, Google Ads'i keşfedip yayınlamak için Cast cihazlarını kontrol edebilir. Böylece, kullanıcı izni reddederse yayın.

Kullanıcı deneyimini iyileştirmek için SDK'da kullanıcı deneyimiyle ilgili bazı değişiklikler yapıyoruz. standart cihaz seçiciyi kullanan uygulamalar için geçerlidir. Kullanıcı deneyimiyle ilgili bu değişiklikler Kullanıcılara yerel ağ erişim izinlerinin neden gerekli olduğunu ve Ayrıca, yerel ağ cihazı erişimi sağlanmışsa yayının nasıl etkinleştirileceğini devre dışı bırakıldı.

Cast SDK'sının v4.4.8 veya önceki sürümleri kullanılarak oluşturulmuş uygulamalar devam edecektir. çalıştırılması gerekir. Şu durumda: veya Xcode 12 veya sonraki bir sürüme sahip iOS 14 için Cast'e güncellemenizi öneririz. Cast uygulamanızın düzgün çalışmaya devam etmesini sağlamak için SDK 4.6.0 veya üzeri sürümler.

Cast iOS SDK 4.6.0 veya sonraki sürümleri, CocoaPods ile aşağıdaki adımları izleyerek indirilebilir: CocoaPods kurulumunu yapabilir veya manuel kurulum talimatlarını uygulayın. Bu sürüm kullanılan temel keşif mekanizmasında yapılan değişiklikler sayesinde, Xcode 12 ile geliştirilmiştir. Yayın düğmesi, her zaman görüntülenir. Kullanıcı Cast'e dokunduğunda kullanılabilir cihaz yoksa düğmesi, cihazların neden bağlı olmadığı konusunda yol gösteren bir iletişim mevcut (yerel ağ erişiminin nasıl yeniden etkinleştirileceğiyle ilgili bilgiler dahil) iznidir.

Cast SDK'sı değişiklikleri

İlk kez yayınlama

Bir kullanıcı ilk kez yayın yapmayı denediğinde yerel ağ erişimi (LNA) yerel ağ iletişimi erişiminin neden geçerli olduğunu açıklayan geçiş reklamı iletişim kutusu ardından Apple'ın sağladığı iOS yerel ağ erişim izinleri tıklayın. Aşağıdaki örneklerde akış gösterilmektedir:

Yerel ağ erişim izinleri akışı

Yayın kullanılamıyor

iOS gönderen SDK 4.6.0 sürümünden itibaren, kullanıcı şu işlemleri gerçekleştirdiğinde yayın düğmesi her zaman görünür: kablosuz ağa bağlı. Yayın cihazları kullanılamadığında Yayın düğmesine dokunduğunuzda, kullanıcıya aşağıdaki örneklerde gösterildiği gibi Cast'in kullanılamamasının olası nedenleri hakkında ipuçları:

Yayın ile akış kullanılamıyor

iOS 14'te uygulamanızı güncelleme

  1. Cast iOS SDK 4.8.3'ü projenize ekleyin

    CocoaPods kullanıyorsanız 4.8.3 SDK'sını projenize eklemek için pod update kullanın.

    Aksi halde alarak SDK'yı manuel olarak alabilirsiniz.

  2. NSBonjourServices adlı cihazı Info.plist cihazınıza ekleyin

    Info.plist öğenizde NSBonjourServices öğesini belirterek iOS 14'te yerel ağ keşfinin başarılı olmasını sağlar.

    Hem _googlecast._tcp hem de _<your-app-id>._googlecast._tcp cihazı için hizmet olarak düzgün çalışmasını sağlamalısınız.

    appID, alıcı kimliğinizdir. Bu, GCKDiscoveryCriteria

    Aşağıdaki örnek NSBonjourServices tanımını güncelleyin ve değiştirin: "ABCD1234" uygulama kimliğinizle girin.

    &lt;key&gt;NSBonjourServices&lt;/key&gt;
    &lt;array&gt;
      &lt;string&gt;_googlecast._tcp&lt;/string&gt;
      &lt;string&gt;_ABCD1234._googlecast._tcp&lt;/string&gt;
    &lt;/array&gt;
  3. NSLocalNetworkUsageDescription adlı yeri şuraya ekleyin: Info.plist

    Yerel Rehberler Ağı'nda gösterilen mesajı özelleştirmenizi Uygulamanıza uygulamaya özel izin dizesi ekleyerek ağ istemi Şu öğe için Info.plist dosyası: NSLocalNetworkUsageDescription (ör. Cast'i açıklamak için) DIAL gibi keşif ve diğer keşif hizmetlerini kullanıyor.

    &lt;key&gt;NSLocalNetworkUsageDescription&lt;/key&gt;
    <string>${PRODUCT_NAME}, kablosuz ağınızda Cast uyumlu cihazları keşfetmek için yerel ağı kullanır
    ağ.</string>

    Bu mesaj, iOS Yerel Ağ Erişimi iletişim kutusunun bir parçası olarak şu şekilde görünecektir: örnek olarak verilebilir.

    Yerel Ağ Erişimi izinleri yayınlama iletişim kutusu resmi
  4. Uygulamanızı Apple App Store'da yeniden yayınlayın

    Ayrıca uygulamanızı şu sürümle yeniden yayınlamanızı öneririz: en kısa sürede değiştirmelisiniz.

Özelleştirmeler

Yayın cihazı keşfini başlatma

Varsayılan olarak yayın cihazı keşfi, kullanıcı ilk dokunduğunda başlatılır Yayınla düğmesine (GCKUICastButton) basın. Kullanıcı bu işlemi ilk kez iOS sürümüne geçildikten sonra yerel ağda Cast uygulamasını kullanmaya çalıştı 14'te yeni LNA geçiş reklamı görünür ve ardından iOS yerel ağı gelir. Erişim izinleri iletişim kutusu.

Cihaz bulmanın ne zaman başlayacağını kontrol etmenize olanak tanıyan yeni bir işaret kullanıma sunuldu ve kullanıcı deneyiminin belirli öğelerinin davranışı:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

Varsayılan değer: true. Bu işaret yalnızca GCKCastOptions::disableDiscoveryAutostart false olarak ayarlandı.

true değerine ayarlanırsa yayın cihazı keşfi, kullanıcı İlk kez GCKUICastButton. Bilgilendirme amaçlı bir mesaj, kullanıcıya yerel ağ izninin neden bu izin verildiğini bildirerek gerekir. Bu mesajın ardından iOS 14 LNA mesajı gösterilir. Yayın cihazı bulma işlemi, mesaj onaylandıktan sonra başlar.

Sonraki Uygulama lansmanlarında her zaman GCKUICastButton görüntülenir.

false seçeneğine ayarlanırsa cihaz keşfi, işaret GCKCastOptions::disableDiscoveryAutostart

Sık sorulan sorular

Uygulamamı yeniden yayınlarsam ne olur? Cast SDK v4.4.8 ve Xcode 12 içeren Cast gönderen uygulaması nedir?

Uygulamanız yerel ağda yayın cihazlarını keşfedemeyebilir (Apple'dan ağ iletişimi çoklu yayın yararlanma hakkı almadıysanız) Apple'ın yalnızca bir amaç belirtin. Xcode 12 ile geliştirmeyi planlıyorsanız uygulamanızı yayınlamanız gerekir. 4.6.0 sürümünün yüklü olduğu bir özelliktir.

Uygulamamı yeni Cast SDK'sı ile yeniden yayınlarsam iOS 13 veya önceki sürümleri çalıştıran kullanıcılarım deneyimlenecek mi?

Eskiden sahip oldukları kullanıcı deneyimini görmeye devam ederler. uygulamanızın yeniden yayınlanması. Kullanıcıların görebildiği değişiklikler kullanıcılarla sınırlıdır Android 14'te yüklüyoruz.

Yeni uygulama kullanıma sunulduğunda uygulamamı güncellemek için ne yapmam gerekiyor Cast SDK'nın sürümü yayınlandı mı?

  • Uygulamanızın Info.plist ayarını yerel ağ içerecek şekilde güncelleyin kullanım açıklaması.
  • NSBonjourServices öğesini uygulamanızın Info.plist ve Cast için Bonjour hizmet adlarını sağlayın. ve uygulama kimliğiniz.
  • Gönderen uygulamanızı Cast SDK'sı 4.6.0'ı kullanacak şekilde yeni sürüme geçirin.
  • Uygulamanızı Apple App Store'da yeniden yayınlayın.

Özel cihazımda cihazlar neden artık görünmüyor? hangi aracı tercih edeceğim.

Özel bir cihaz kullanıyorsanız meydana gelebilecek bilinen bir sorundur standart cihaz seçici yerine cihaz seçicisini kullanabilirsiniz. Cast SDK ve önceki sürümler, cihaz tarama otomatik olarak yapılıyordu. Sürümden itibaren 4.6.0'da, startDiscovery öğesini açıkça çağırmanız gerekir. yöntemini GCKDiscoveryManager sınıfını kullanın.

Bu değişikliğin nedeni, Yerel Ağ Erişimi (LNA) uygulama ilk kez taradıktan sonra izin istemi görünür gerekir. Bu durum, izin iletişim kutularının rastgele yerlerde görünmesine neden olabilir dokunun.

Uygulamaları için özel bir cihaz seçici oluşturan geliştiriciler cihazı başlatmadan önce tek seferlik bir geçiş reklamı sağlaması beklenir ilk kez tarama yapıyor.

iOS 13

iOS 13'te kullanıma sunulan yeni izin gereksinimleri, uygulamaları hakkında bilgi edindiniz.

Google Cast SDK'sı 4.4.3 sürümünden itibaren, Bluetooth® izni gerektirmez. Bu özellik, hem geliştirici hem de sitesinde ve yeni google-cast-sdk-no-bluetooth Cocoapod.

Uygulama dökümü

Şu anda kullandığınız iOS SDK'sının sürümüne göre belirlenen ayrıntıları aşağıda bulabilirsiniz şunu kullanarak:

iOS 12 SDK veya önceki sürümlerle oluşturulan uygulamalar

  • Önerilen İşlem. Cihaz bulma performansı şu durumlarda düşebilir: iOS 13'te çalışan bir uygulamadır ancak işlevsel olmaya devam edecektir. Kesinlikle öneririm geliştiriciler, mevcut olduğunda Cast SDK'sının 4.4.4 sürümüne geçer.
  • iOS 13, kullanıcılardan uygulamaya Bluetooth® izinlerini vermelerini isteyecektir.

iOS 13 SDK'sı ile oluşturulan uygulamalar

  • İşlem Gerekli: Cast SDK'sı 4.4.4 sürümüne güncelleyin. Aksi takdirde yayın düğmesi düzgün çalışmayabilir. kullanıcı konum izni vermezse görünür. Cast SDK'sına yükseltme 4.4.4, iOS 13'te güvenilir bir yayınlama deneyimi sağlamak için gereklidir.