Uprawnienia i odkrywanie w iOS

Aplikacje, które skanują sieć lokalną w poszukiwaniu urządzeń, będą teraz wyświetlać użytkownikom jednorazowe okno uprawnień, aby znaleźć urządzenia w sieci lokalnej i połączyć się z nimi. Platforma Cast korzysta z sieci lokalnej do wykrywania urządzeń Cast i sterowania nimi, więc jeśli użytkownik odmówi uprawnień, nie będzie mógł przesyłać treści.

Aby poprawić wrażenia użytkowników, wprowadzamy pewne zmiany w interfejsie pakietu SDK w przypadku aplikacji, które korzystają ze standardowego selektora urządzeń. Te zmiany w interfejsie użytkownika sprawiają, że użytkownicy lepiej rozumieją, dlaczego potrzebne są uprawnienia dostępu do sieci lokalnej, oraz jak włączyć przesyłanie, jeśli dostęp do urządzenia w sieci lokalnej został wyłączony.

Pakiet Cast iOS SDK w wersji 4.6.0 lub nowszej można dodać za pomocą narzędzia Swift Package Manager, postępując zgodnie z instrukcjami konfiguracji narzędzia Swift Package Manager, lub pobrać ręcznie, postępując zgodnie z instrukcjami konfiguracji ręcznej. Ta wersja zawiera zmiany w podstawowym mechanizmie wykrywania, które umożliwiają aplikacjom utworzonym za pomocą Xcode 12 znajdowanie urządzeń Cast w sieci. Przycisk Cast powinien być teraz zawsze widoczny. Jeśli po kliknięciu przycisku Cast nie są dostępne żadne urządzenia, wyświetli się okno z informacjami o tym, dlaczego urządzenia mogą być niedostępne, oraz o tym, jak ponownie włączyć uprawnienia dostępu do sieci lokalnej.

Zmiany w pakiecie Cast SDK

Przesyłanie po raz pierwszy

Gdy użytkownik po raz pierwszy spróbuje przesłać treści, pojawi się okno dostępu do sieci lokalnej (LNA) z wyjaśnieniem, dlaczego jest on potrzebny, a następnie prośba o przyznanie uprawnień dostępu do sieci lokalnej na iOS od Apple. Poniższe makiety ilustrują ten proces:

Przesyłanie jest niedostępne

Od wersji 4.6.0 pakietu SDK nadawcy na iOS przycisk Cast jest zawsze widoczny, gdy użytkownik jest połączony z Wi-Fi. Gdy urządzenia przesyłające są niedostępne, kliknięcie przycisku Cast powoduje wyświetlenie okna z informacjami o możliwych przyczynach niedostępności, jak pokazano na poniższych makietach:

Aktualizowanie aplikacji

1. Dodawanie do projektu pakietu Cast iOS SDK 4.8.6

   Jeśli używasz Swift Package Managera, zaktualizuj pakiet google-cast-ios-sdk do wersji 4.8.6.

   W przeciwnym razie pobierz pakiet SDK ręcznie.

2. Dodawanie NSBonjourServices do Info.plist

   Aby umożliwić wykrywanie sieci lokalnej, podaj NSBonjourServices w Info.plist.

   Aby wykrywanie urządzeń działało prawidłowo, musisz dodać jako usługi zarówno _googlecast._tcp, jak i _<your-app-id>._googlecast._tcp.

   appID to identyfikator odbiornika, który jest taki sam jak identyfikator zdefiniowany w GCKDiscoveryCriteria.

   Zaktualizuj podaną niżej przykładową definicję NSBonjourServices i zastąp „ABCD1234” identyfikatorem aplikacji.

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

3. Dodaj NSLocalNetworkUsageDescription do Info.plist

   Zdecydowanie zalecamy dostosowanie wiadomości wyświetlanej w prośbie o dostęp do sieci lokalnej przez dodanie ciągu uprawnień aplikacji w pliku Info.plist aplikacji dla NSLocalNetworkUsageDescription, aby opisać wykrywanie Cast i inne usługi wykrywania, takie jak DIAL.

   <key>NSLocalNetworkUsageDescription</key>
   <string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
   network.</string>

   Ten komunikat pojawi się w oknie dostępu do sieci lokalnej na iOS, jak pokazano na makiecie.

   
4. Ponowne opublikowanie aplikacji w Apple App Store

   Zalecamy jak najszybsze ponowne opublikowanie aplikacji przy użyciu wersji 4.8.6.

Dostosowania

Rozpoczęcie wykrywania urządzeń Cast

Domyślnie wykrywanie urządzeń Cast jest inicjowane, gdy użytkownik po raz pierwszy kliknie przycisk Cast (GCKUICastButton). Jeśli użytkownik po raz pierwszy próbuje użyć aplikacji Cast w sieci lokalnej, pojawi się nowa reklama pełnoekranowa LNA, a następnie okno uprawnień dostępu do sieci lokalnej na iOS.

Dostępna jest nowa flaga, która pozwala kontrolować, kiedy rozpoczyna się wykrywanie urządzeń, oraz zachowanie niektórych elementów interfejsu UX:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

Wartością domyślną jest true. Ta flaga ma zastosowanie tylko wtedy, gdy flaga GCKCastOptions::disableDiscoveryAutostart jest ustawiona na false.

Jeśli ustawisz wartość true, wykrywanie urządzeń przesyłających rozpocznie się, gdy użytkownik po raz pierwszy kliknie GCKUICastButton. Użytkownik zobaczy komunikat z informacją, dlaczego potrzebne jest uprawnienie do sieci lokalnej. Po tej wiadomości wyświetli się wiadomość dotycząca ograniczonego dostępu do reklam na iOS. Wykrywanie urządzeń przesyłających rozpocznie się po potwierdzeniu wiadomości.

W kolejnych uruchomieniach aplikacji zawsze wyświetla się GCKUICastButton.

Jeśli zasada jest ustawiona na false, wykrywanie urządzeń rozpocznie się na podstawie wartości flagi GCKCastOptions::disableDiscoveryAutostart.

Najczęstsze pytania