Desarrolla para redes satelitales restringidas

Algún día, las redes satelitales serán lo suficientemente sólidas como para funcionar como redes normales y trabajar sin problemas con todos los casos de uso de las apps, pero, por ahora, los datos en estas redes son un recurso escaso. Una red satelital con restricciones en el uso de datos se denomina red satelital restringida.

Debido a estas restricciones, las apps para Android no usan estas redes de forma predeterminada. Si quieres que tu app funcione en redes satelitales con restricciones, debes identificarla como optimizada para el uso de datos satelitales y adaptar sus casos de uso para conservar recursos cuando se conecte a una red satelital con restricciones.

Adapta los casos de uso de tu app

Lo único que debes hacer para permitir que tu app acceda a redes satelitales restringidas es habilitar la opción, pero es posible que debas realizar más cambios para optimizar el comportamiento de tu app y usar los recursos de red limitados de manera responsable. Estos son algunos aspectos que debes tener en cuenta cuando optimizas el uso de datos restringido:

• Decide si tu app es apta para usarse en redes con restricciones. En algunas circunstancias, ciertas apps no son adecuadas para redes con limitaciones de datos. Por ejemplo, las apps de transmisión de video pueden optar por no usar redes satelitales en absoluto, aunque podrían identificar la presencia de una red satelital y avisarle al usuario que no funcionarán en la red limitada existente.
• Identifica los casos de uso específicos que deseas limitar o modificar. Algunas funciones de tu app podrían ser más adecuadas para condiciones de datos limitados que otras. Por ejemplo, enviar mensajes de texto funcionaría bien, pero intentar subir videos en HD probablemente generaría una mala experiencia del usuario. Esto es similar a la forma en que muchas apps cambian su comportamiento cuando se encuentran en roaming.
• Adapta la forma en que tu app usa los recursos de red. Las redes restringidas funcionan mejor cuando las apps realizan operaciones de red en ráfagas y pasan la mayor parte del tiempo sin usar la red. Evita crear tráfico de red constante o excesivo. Por ejemplo, el audio de pulsar para hablar es mucho más adecuado para condiciones de red limitadas que las llamadas de audio en tiempo real.

También hay cambios específicos que debes realizar si tu app usa lógica de redes compleja o Firebase Cloud Messaging.

Identificarse como optimizado para redes con restricciones

Para identificar tu app como optimizada para redes restringidas y habilitar su uso, actualiza tu archivo de manifiesto de la app con un elemento <meta-data> de la siguiente manera:

<meta-data android:name="android.telephony.PROPERTY_SATELLITE_DATA_OPTIMIZED"
          android:value="PACKAGE_NAME" />

Este elemento permite que tu app use una red satelital restringida cuando es la única red disponible. También notifica al sistema que tu app está optimizada para redes con limitaciones, lo que ayuda a los usuarios a descubrirla, ya que se muestra entre las apps compatibles con satélites en la app de configuración.

Nota: No agregues esta etiqueta a tu manifiesto cuando desarrolles una biblioteca. Permite que las apps que usan tu biblioteca se identifiquen por sí mismas según corresponda.

Cambia el comportamiento en condiciones de datos restringidos

Si necesitas cambiar el comportamiento de tu app cuando se usa una red restringida o si tu app tiene lógica preexistente que usa ConnectivityManager para administrar el uso de la red, deberás realizar algunos cambios en el flujo de la red.

Detecta condiciones de datos restringidos

El objeto NetworkCapabilities que se usa para las solicitudes de red incluye un bit NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED que se establece de forma predeterminada en todas las redes y se quita en las redes con restricciones de ancho de banda. Para determinar si una red tiene limitaciones de ancho de banda, verifica si tiene la capacidad NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED.

Trabaja con redes restringidas

Los objetos NetworkRequest también incluyen la capacidad NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED de forma predeterminada. Quita esta capacidad para indicar que se aceptan las redes restringidas.

Cuando detectes que te conectaste a una red restringida, puedes adaptar las funciones de tu app según sea necesario:

Kotlin

val HandlerThread = HandlerThread("SatelliteNetworkMonitor"
handlerThread.start()
val handler = Handler(handlerThread.getLooper())

// Make the network request.
val request = NetworkRequest.Builder()
    .addCapability(NET_CAPABILITY_INTERNET
    .removeCapability(NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED)
    .build()

// Register for the callback.
val callback = NetworkCallback() {
    override fun onCapabilitiesChanged(net: Network, nc: NetWorkCapabilities) {
        updateAppUseCases(net, nc)
    }

    fun updateAppUseCases(net: Network, nc: NetworkCapabilities) {
        if (!nc.hasCapability(NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED) ||
             nc.hasTransport(NetworkCapabilities.TRANSPORT_SATELLITE)) {
            // Adapt to constrained network or disable heavy data usage features.
            ...
        } else {
            // Revert to unconstrained behavior.
            ...
        }
    }
}
// Where cm is your ConnectivityManager object:
cm.registerBestMatchingNetworkCallback(request, callback, handler)

Java

HandlerThread handlerThread = new HandlerThread("SatelliteNetworkMonitor");
handlerThread.start();
Handler handler = new Handler(handlerThread.getLooper());

// Make the network request.
NetworkRequest request = new NetworkRequest.Builder()
    .addCapability(NET_CAPABILITY_INTERNET)
    .removeCapability(NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED)
    .build();

// Register for the callback.
NetworkCallback callback = new NetworkCallback() {
    @Override
    public void onCapabilitiesChanged(Network net, NetworkCapabilities nc) {
        updateAppUsecases(net, nc);
    }
    private void updateAppUsecases(Network net, NetworkCapabilities nc) {
        if (!nc.hasCapability(NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED) || nc.hasTransport(NetworkCapabilities.TRANSPORT_SATELLITE)) {
            // Adapt to constrained network or disable heavy data usage features.
            ...
        } else {
            // Revert to unconstrained behavior.
            ...
        }
    }
};
// Where cm is your ConnectivityManager object:
cm.registerBestMatchingNetworkCallback(request, callback, handler);

Nota: No hay dependencias específicas del SDK para acceder a redes satelitales restringidas. Puedes codificar de forma rígida los valores enteros para NET_CAPABILITY_NOT_BANDWIDTH_CONSTRAINED y TRANSPORT_SATELLITE en versiones anteriores de Android, pero en Android 16 y versiones posteriores, las apps deben usar las capacidades de red como se demostró, controlando las excepciones que arroja ConnectivityManager.

Cómo recibir mensajes de FCM en redes con restricciones

Si tu app usa Firebase Cloud Messaging (FCM) para recibir mensajes de un servidor de apps, puedes indicar que se debe entregar un mensaje específico incluso en redes con restricciones. Para ello, incluye la marca bandwidth_constrained_ok cuando pases el mensaje al servidor de FCM:

{
  "message":{
    "token":"bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
    "notification":{
      "title":"Portugal vs. Denmark",
      "body":"great match!"
    }
    "android": {
       "bandwidth_constrained_ok": true
    }
  }
}

Si un mensaje no incluye esta marca, el servidor de FCM solo lo entrega cuando el dispositivo está conectado a través de una red sin restricciones.

Nota: Usa la marca bandwidth_constrained_ok solo si actualizaste la app correspondiente para que funcione en redes satelitales restringidas.