Permisos y detección de iOS

A partir de iOS 14, el sistema operativo aplicará nuevas restricciones y permisos que afectarán la experiencia del usuario de Cast. También afectará la forma en que compilas el SDK de Cast en tu app. Para que tu app mantenga la funcionalidad de Cast con las versiones más recientes de iOS, debes realizar actualizaciones para controlar estos cambios de permisos.

iOS 14

Los desarrolladores deben actualizar sus apps de remitente de Cast para iOS al SDK de Google Cast v4.6.0 o una versión posterior. Estas versiones proporcionan compatibilidad con iOS 14 y sus requisitos.

A partir de iOS 14, las aplicaciones que analicen dispositivos en la red local ahora les mostrarán a los usuarios un diálogo de permisos únicos para encontrar dispositivos de la red local y conectarse a ellos. La plataforma de Cast usa la red local para descubrir y controlar dispositivos Cast, por lo que, si el usuario rechaza el permiso, no podrá transmitir contenido.

Para mejorar la experiencia del usuario, estamos realizando algunas modificaciones en la UX del SDK para las apps que usan el selector de dispositivos estándar. Estas modificaciones de la UX hacen que sea más obvio para los usuarios por qué se necesitan los permisos de acceso a la red local, así como la forma de habilitar la transmisión si se inhabilitó el acceso a los dispositivos de la red local.

Las apps compiladas con versiones del SDK de Cast que usan la versión 4.4.8 o una anterior seguirán funcionando siempre que se compilen con Xcode 11.7 o una versión anterior. Si compilas para iOS 14 con Xcode 12 o versiones posteriores, te recomendamos que actualices al SDK de Cast v4.6.0 o una versión posterior para asegurarte de que tu app de Cast siga funcionando correctamente.

El SDK de Cast para iOS v4.6.0 o una versión posterior se puede descargar con CocoaPods siguiendo la configuración de CocoaPods o de forma manual siguiendo la configuración manual. Esta versión incluye cambios en el mecanismo de descubrimiento subyacente para permitir que las apps compiladas con Xcode 12 encuentren dispositivos Cast en la red. El botón de Cast ahora siempre debería mostrarse. Si no hay dispositivos disponibles cuando el usuario presiona el botón de Cast, se mostrará un diálogo que proporciona orientación sobre por qué es posible que los dispositivos no estén disponibles, incluida información sobre cómo volver a habilitar el permiso de acceso a la red local.

Cambios en el SDK de Cast

Transmisión por primera vez

La primera vez que un usuario intenta transmitir contenido, aparecerá un diálogo intersticial de acceso a la red local (LNA) que explica por qué se necesita el acceso a la red local, seguido de la solicitud de permisos de acceso a la red local de iOS proporcionada por Apple. Las siguientes maquetas ilustran el flujo:

Flujo de permisos de acceso a la red local

Cast no está disponible

A partir del SDK de remitente de iOS 4.6.0, el botón de Cast siempre aparece cuando el usuario está conectado a Wi-Fi. Cuando los dispositivos Cast no están disponibles, si se presiona el botón de Cast, se muestra un diálogo que le da al usuario sugerencias sobre los posibles motivos por los que Cast no está disponible, como se muestra en las siguientes maquetas:

Flow con Cast no disponible

Cómo actualizar tu app en iOS 14

Agrega el SDK de Cast para iOS 4.8.4 a tu proyecto
Si usas CocoaPods, usa pod update para agregar el SDK 4.8.4 a tu proyecto.

De lo contrario, extrae el SDK de forma manual.

Nota: Si compilaste un selector de dispositivos personalizado en tu app, deberás llamar de forma explícita al método startDiscovery en la GCKDiscoveryManager clase para iniciar el descubrimiento de dispositivos. El análisis automático se inhabilitó de forma predeterminada a partir de la versión 4.5.0 del SDK de Cast.
Agrega NSBonjourServices a tu Info.plist
Especifica NSBonjourServices en tu Info.plist para permitir que el descubrimiento de la red local se realice correctamente en iOS 14.

Deberás agregar _googlecast._tcp y _<your-app-id>._googlecast._tcp como servicios para que el descubrimiento de dispositivos funcione correctamente.

El appID es tu receiverID, que es el mismo ID que se define en tu GCKDiscoveryCriteria.

Actualiza la siguiente definición de ejemplo de NSBonjourServices y reemplaza "ABCD1234" por tu appID.
```
<key>NSBonjourServices</key>
<array>
  <string>_googlecast._tcp</string>
  <string>_ABCD1234._googlecast._tcp</string>
</array>
```
Agrega NSLocalNetworkUsageDescription a tu Info.plist
Te recomendamos que personalices el mensaje que se muestra en la solicitud de red local agregando una cadena de permisos específica de la app en el archivo Info.plist de tu app para NSLocalNetworkUsageDescription, como para describir el descubrimiento de Cast y otros servicios de descubrimiento, como DIAL.
```
<key>NSLocalNetworkUsageDescription</key>
<string>${PRODUCT_NAME} uses the local network to discover Cast-enabled devices on your WiFi
network.</string>
```
Este mensaje aparecerá como parte del diálogo de acceso a la red local de iOS, como se muestra en la maqueta.
Vuelve a lanzar tu app en la App Store de Apple
Te recomendamos que vuelvas a lanzar tu app con la versión 4.8.4 lo antes posible.

Personalizaciones

Inicio del descubrimiento de dispositivos Cast

De forma predeterminada, el descubrimiento de dispositivos Cast se inicia la primera vez que el usuario presiona el botón de Cast (GCKUICastButton). Si es la primera vez que el usuario intenta usar la app de Cast en la red local después de actualizar a iOS 14, aparecerá el nuevo intersticial de LNA, seguido del diálogo de permisos de acceso a la red local de iOS.

Hay una nueva marca disponible para permitirte controlar cuándo comienza el descubrimiento de dispositivos y el comportamiento de ciertos elementos de la UX:

startDiscoveryAfterFirstTapOnCastButton: BOOL(true/false)

El valor predeterminado es true. Esta marca solo es aplicable cuando la marca GCKCastOptions::disableDiscoveryAutostart se establece en false.

Si se establece en true, el descubrimiento de dispositivos Cast comienza cuando un usuario presiona GCKUICastButton por primera vez. Se mostrará un mensaje informativo al usuario para informarle por qué se necesita el permiso de red local. Después de ese mensaje, se mostrará el mensaje de LNA de iOS 14. El descubrimiento de dispositivos Cast comienza después de que se reconoce el mensaje.

En los lanzamientos posteriores de la app, GCKUICastButton siempre se muestra.

Si se establece en false, el descubrimiento de dispositivos comenzará según el valor de la marca GCKCastOptions::disableDiscoveryAutostart.

Preguntas frecuentes

¿Qué sucede si vuelvo a lanzar mi app de remitente de Cast con el SDK de Cast v4.4.8 y Xcode 12?

Es posible que tu app no pueda descubrir dispositivos Cast en la red local a menos que hayas obtenido un derecho de transmisión múltiple de Apple. Ten en cuenta que Apple no otorgará derechos de transmisión múltiple únicamente con el propósito de admitir Cast. Si planeas compilar con Xcode 12, debes lanzar tu app con Cast 4.6.0.

Si vuelvo a lanzar mi app con el nuevo SDK de Cast, ¿qué experimentarán mis usuarios que ejecutan iOS 13 o versiones anteriores?

Seguirán viendo la misma experiencia del usuario que tenían antes de volver a lanzar tu app. Los cambios visibles para el usuario se limitan a los usuarios que ejecutan iOS 14.

¿Qué debo hacer para actualizar mi app una vez que se lance la nueva versión del SDK de Cast?

Actualiza el Info.plist de tu app para incluir una descripción del uso de la red local.
Agrega NSBonjourServices al Info.plist de tu app y proporciona los nombres del servicio Bonjour para Cast y el ID de tu app.
Actualiza tu app de remitente para usar el SDK de Cast 4.6.0.
Vuelve a lanzar tu app en la App Store de Apple.

¿Por qué los dispositivos dejaron de aparecer en mi selector de dispositivos personalizado después de actualizar a la versión 4.6.0?

Este es un problema conocido que puede ocurrir si usas un selector de dispositivos personalizado en lugar del selector de dispositivos estándar. En la versión 4.4.8 del SDK de Cast y versiones anteriores, el análisis de dispositivos era automático. A partir de la versión 4.6.0, deberás llamar de forma explícita al startDiscovery método en la GCKDiscoveryManager clase para iniciar el descubrimiento de dispositivos.

El motivo de este cambio es que la solicitud de permisos de acceso a la red local (LNA) aparecerá después de que la app se analice por primera vez. Esto podría hacer que los diálogos de permisos aparezcan en lugares aleatorios en tu app.

Se espera que los desarrolladores que compilen un selector de dispositivos personalizado para su app proporcionen un intersticial único antes de iniciar el análisis de dispositivos por primera vez en iOS 14.

iOS 13

Con iOS 13, se introdujeron nuevos requisitos de permisos que afectan a las apps que usan el SDK de Google Cast.

A partir del SDK de Google Cast v4.4.3, está disponible un SDK adicional que no requiere permiso de Bluetooth®. Está disponible en el sitio para desarrolladores y en el nuevo google-cast-sdk-no-bluetooth Cocoapods.

Desglose de la app

A continuación, se muestra un desglose según la versión del SDK de iOS que usas actualmente:

Apps compiladas con el SDK de iOS 12 o versiones anteriores

Acción recomendada. El rendimiento del descubrimiento de dispositivos puede disminuir cuando se ejecuta en iOS 13, pero seguirá funcionando. Recomendamos que los desarrolladores actualicen al SDK de Cast v4.4.4 cuando esté disponible.
iOS 13 les solicitará a los usuarios que otorguen permisos de Bluetooth® a la app.

Apps compiladas con el SDK de iOS 13

Acción obligatoria: Actualiza al SDK de Cast 4.4.4 o es posible que no aparezca el botón de Cast si el usuario no otorga permiso de ubicación. Es necesario actualizar al SDK de Cast 4.4.4 para garantizar una experiencia de transmisión confiable en iOS 13.

Privacidad

Cómo integrar la transmisión