Разрешения iOS и обнаружение

Приложения, которые сканируют устройства в локальной сети, теперь будут показывать пользователям диалоговое окно с запросом однократного разрешения на поиск устройств в локальной сети и подключение к ним. Платформа Cast использует локальную сеть, чтобы находить устройства с поддержкой Cast и управлять ими. Если пользователь не предоставит разрешение, он не сможет транслировать контент.

Чтобы улучшить взаимодействие с приложением, мы внесли изменения в интерфейс SDK для приложений, в которых используется стандартный выбор устройства. Эти изменения в интерфейсе помогут пользователям понять, зачем нужны разрешения на доступ к локальной сети и как включить трансляцию, если доступ к устройствам локальной сети отключен.

Cast iOS SDK версии 4.6.0 или более поздней можно добавить с помощью Swift Package Manager, следуя инструкциям по настройке, или скачать вручную, следуя инструкциям по настройке. В этой версии изменен основной механизм обнаружения, чтобы приложения, созданные с помощью Xcode 12, могли находить устройства Cast в сети. Кнопка трансляции должна отображаться всегда. Если при нажатии на кнопку Cast устройства будут недоступны, появится диалоговое окно с информацией о том, почему это может происходить, и инструкциями по повторному включению доступа к локальной сети.

Изменения в Cast SDK

Первая трансляция

При первой попытке использовать Cast появится диалоговое окно с объяснением, почему требуется доступ к локальной сети (LNA), а затем запрос на разрешение доступа к локальной сети от Apple. Ниже приведены макеты, иллюстрирующие процесс:

Трансляция недоступна

Начиная с версии 4.6.0 SDK отправителя для iOS кнопка трансляции всегда показывается, когда устройство пользователя подключено к сети Wi-Fi. Если Cast-устройства недоступны, при нажатии на кнопку трансляции появляется диалоговое окно с подсказками о возможных причинах, как показано на макетах ниже.

Обновление приложения

1. Как добавить Cast iOS SDK 4.8.6 в проект

   Если вы используете Swift Package Manager, обновите пакет google-cast-ios-sdk до версии 4.8.6.

   В противном случае добавьте SDK вручную.

2. Добавьте NSBonjourServices в Info.plist

   Укажите NSBonjourServices в Info.plist, чтобы разрешить обнаружение локальной сети.

   Чтобы обнаружение устройств работало правильно, вам нужно добавить в качестве сервисов _googlecast._tcp и _<your-app-id>._googlecast._tcp.

   appID – это receiverID, который совпадает с идентификатором, заданным в GCKDiscoveryCriteria.

   Измените определение NSBonjourServices в следующем примере и замените "ABCD1234" на идентификатор своего приложения.

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

3. Добавьте NSLocalNetworkUsageDescription в Info.plist

   Мы настоятельно рекомендуем добавить в файл Info.plist приложения строку с разрешением для NSLocalNetworkUsageDescription, чтобы настроить сообщение, которое показывается в запросе доступа к местной сети. Например, можно добавить описание обнаружения Cast и других сервисов обнаружения, таких как DIAL.

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

   Это сообщение будет показываться в диалоговом окне доступа к локальной сети в iOS, как показано на макете.

   
4. Повторно опубликуйте приложение в Apple App Store

   Мы рекомендуем как можно скорее повторно опубликовать приложение, используя версию 4.8.6.

Настройки

Инициация обнаружения Cast-устройства

По умолчанию поиск устройств Cast запускается, когда пользователь впервые нажимает кнопку Cast (GCKUICastButton). Если пользователь впервые пытается использовать приложение Cast в локальной сети, сначала появится новое межстраничное объявление LNA, а затем диалоговое окно с запросом разрешения на доступ к локальной сети iOS.

Добавлен новый флаг, позволяющий контролировать начало обнаружения устройств и поведение некоторых элементов интерфейса:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

Значение по умолчанию: true. Этот флаг применяется, только если флаг GCKCastOptions::disableDiscoveryAutostart имеет значение false.

Если задано значение true, поиск Cast-устройств начнется, когда пользователь впервые нажмет на кнопку GCKUICastButton. Пользователь увидит информационное сообщение с объяснением, зачем нужно разрешение на доступ к локальной сети. После этого сообщения будет показано сообщение LNA для iOS. Поиск устройств для трансляции начнется после того, как вы подтвердите сообщение.

При последующих запусках приложения значок GCKUICastButton будет отображаться всегда.

Если задано значение false, обнаружение устройств начнется на основе значения флага GCKCastOptions::disableDiscoveryAutostart.

Часто задаваемые вопросы