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:

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ı:

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.

   <key>NSBonjourServices</key>
   <array>
     <string>_googlecast._tcp</string>
     <string>_ABCD1234._googlecast._tcp</string>
   </array>

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.

   <key>NSLocalNetworkUsageDescription</key>
   <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.

   
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

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.