Establecer la orientación de la pantalla en una aplicación

La biblioteca de interfaz de usuario de Azure Communication Services permite a los desarrolladores establecer la orientación de las pantallas en una aplicación. Puede especificar el modo de orientación de pantalla en la pantalla de configuración de llamadas y en la pantalla de llamada de la biblioteca de interfaz de usuario.

Requisitos previos

• Una cuenta de Azure con una suscripción activa. Cree una cuenta gratuita.
• Un recurso de Communication Services implementado. Cree un recurso de Communication Services.
• Un token de acceso de usuario para habilitar el cliente de llamada. Obtenga un token de acceso de usuario.
• Opcional: Finalización del inicio rápido para empezar a trabajar con los compuestos de la biblioteca de interfaz de usuario.

Establecer la orientación de la pantalla

Para obtener más información, consulte la biblioteca de interfaz de usuario de Android de código abierto y el código de aplicación de ejemplo.

Orientaciones disponibles

En la tabla siguiente se enumeran CallCompositeSupportedScreenOrientation los tipos para las orientaciones listas para usar. Si desea establecer la orientación de las distintas pantallas de la composición, establezca en CallCompositeSupportedScreenOrientation CallComposite.

Modo de orientación	Tipo CallCompositeSupportedScreenOrientation
PORTRAIT	CallCompositeSupportedScreenOrientation.PORTRAIT
LANDSCAPE	CallCompositeSupportedScreenOrientation.LANDSCAPE
REVERSE_LANDSCAPE	CallCompositeSupportedScreenOrientation.REVERSE_LANDSCAPE
USER_LANDSCAPE	CallCompositeSupportedScreenOrientation.USER_LANDSCAPE
FULL_SENSOR	CallCompositeSupportedScreenOrientation.FULL_SENSOR
USER	CallCompositeSupportedScreenOrientation.USER

API de orientación

CallCompositeSupportedScreenOrientation es un tipo personalizado para la biblioteca de interfaz de usuario de Android. El nombre del tipo de orientación se define manteniendo la similitud con los nombres de los modos de orientación de la plataforma Android.

De forma predeterminada, la orientación de la pantalla de configuración está en PORTRAIT modo y la pantalla de llamada está en USER modo. Para establecer una orientación diferente para las pantallas, puede pasar CallCompositeSupportedScreenOrientation. De fábrica, la biblioteca de interfaz de usuario incluye un conjunto de CallCompositeSupportedScreenOrientation tipos que se pueden usar con el compuesto.

También puede obtener una lista de CallCompositeSupportedScreenOrientation tipos mediante la función CallCompositeSupportedScreenOrientation.values()estática .

Para establecer la orientación, especifique CallCompositeSupportedScreenOrientation y pásela a CallCompositeBuilder. En el ejemplo siguiente se establece FULL_SENSOR para la pantalla de configuración y LANDSCAPE para la pantalla de llamada de la composición.

Kotlin

import com.azure.android.communication.ui.calling.models.CallCompositeSupportedScreenOrientation

// CallCompositeSupportedLocale provides a list of supported locales
val callComposite: CallComposite =
            CallCompositeBuilder()
            .setupScreenOrientation(CallCompositeSupportedScreenOrientation.FULL_SENSOR)
            .callScreenOrientation(CallCompositeSupportedScreenOrientation.LANDSCAPE)
            .build()

Java

import com.azure.android.communication.ui.calling.models.CallCompositeSupportedScreenOrientation;

// CallCompositeSupportedLocale provides a list of supported locales
CallComposite callComposite = 
    new CallCompositeBuilder()
        .setupScreenOrientation(CallCompositeSupportedScreenOrientation.FULL_SENSOR)
        .callScreenOrientation(CallCompositeSupportedScreenOrientation.LANDSCAPE)
        .build();

Para obtener más información, consulte la biblioteca de interfaz de usuario de iOS de código abierto y el código de aplicación de ejemplo.

Orientaciones disponibles

En la tabla siguiente se enumeran OrientationOptions los tipos para las orientaciones listas para usar. Si desea establecer la orientación de las distintas pantallas de la composición, establezca en OrientationOptions CallComposite.

Modo de orientación	Tipo OrientationOptions
portrait	OrientationOptions.portrait
landscape	OrientationOptions.landscape
landscapeRight	OrientationOptions.landscapeRight
landscapeLeft	OrientationOptions.landscapeLeft
allButUpsideDown	OrientationOptions.allButUpsideDown

API de orientación

OrientationOptions es un tipo personalizado para la biblioteca de interfaz de usuario de iOS. El nombre del tipo de orientación se define manteniendo la similitud con los nombres de los modos de orientación de la plataforma iOS.

De forma predeterminada, la orientación de la pantalla de configuración está en portrait modo y la pantalla de llamada está en allButUpsideDown modo. Para establecer una orientación diferente para las pantallas, puede pasar OrientationOptions. De fábrica, la biblioteca de interfaz de usuario incluye un conjunto de OrientationOptions tipos que se pueden usar con el compuesto.

let callCompositeOptions = CallCompositeOptions(localization: localizationConfig,
                                                setupScreenOrientation: OrientationOptions.portrait,
                                                callingScreenOrientation: OrientationOptions.allButUpsideDown)
let callComposite = CallComposite(withOptions: callCompositeOptions)

Pasos siguientes

• Más información sobre la biblioteca de interfaz de usuario