Impostare l'orientamento dello schermo in un'applicazione

La libreria dell'interfaccia utente Servizi di comunicazione di Azure consente agli sviluppatori di impostare l'orientamento delle schermate in un'applicazione. È possibile specificare la modalità di orientamento dello schermo nella schermata di configurazione delle chiamate e nella schermata di chiamata della libreria dell'interfaccia utente.

Prerequisiti

• Un account Azure con una sottoscrizione attiva. Creare un account gratuitamente.
• Una risorsa di Servizi di comunicazione distribuita. Creare una risorsa di Servizi di comunicazione.
• Token di accesso utente per abilitare il client di chiamata. Ottenere un token di accesso utente.
• Facoltativo: completamento della guida introduttiva per iniziare a usare i compositi della libreria dell'interfaccia utente.

Impostare l'orientamento dello schermo

Per altre informazioni, vedere la libreria dell'interfaccia utente Android open source e il codice dell'applicazione di esempio.

Orientamenti disponibili

Nella tabella seguente sono elencati CallCompositeSupportedScreenOrientation i tipi per gli orientamenti predefiniti. Se si desidera impostare l'orientamento delle varie schermate del composito, impostare su CallCompositeSupportedScreenOrientation CallComposite.

Modalità orientamento	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

Orientation API

CallCompositeSupportedScreenOrientation è un tipo personalizzato per la libreria dell'interfaccia utente Android. Il nome del tipo di orientamento viene definito mantenendo la somiglianza con i nomi delle modalità di orientamento della piattaforma Android.

Per impostazione predefinita, l'orientamento dello schermo di configurazione è in PORTRAIT modalità e la schermata chiamante è in USER modalità. Per impostare un orientamento diverso per le schermate, è possibile passare CallCompositeSupportedScreenOrientation. Per impostazione predefinita, la libreria dell'interfaccia utente include un set di CallCompositeSupportedScreenOrientation tipi utilizzabili con il composito.

È anche possibile ottenere un elenco di CallCompositeSupportedScreenOrientation tipi usando la funzione CallCompositeSupportedScreenOrientation.values()statica .

Per impostare l'orientamento, specificarlo CallCompositeSupportedScreenOrientation e passarlo a CallCompositeBuilder. Nell'esempio seguente viene impostata FULL_SENSOR la schermata di configurazione e LANDSCAPE per la schermata chiamante del composito.

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();

Per altre informazioni, vedere la libreria dell'interfaccia utente iOS open source e il codice dell'applicazione di esempio.

Orientamenti disponibili

Nella tabella seguente sono elencati OrientationOptions i tipi per gli orientamenti predefiniti. Se si desidera impostare l'orientamento delle varie schermate del composito, impostare su OrientationOptions CallComposite.

Modalità orientamento	Tipo OrientationOptions
portrait	OrientationOptions.portrait
landscape	OrientationOptions.landscape
landscapeRight	OrientationOptions.landscapeRight
landscapeLeft	OrientationOptions.landscapeLeft
allButUpsideDown	OrientationOptions.allButUpsideDown

Orientation API

OrientationOptions è un tipo personalizzato per la libreria dell'interfaccia utente iOS. Il nome del tipo di orientamento viene definito mantenendo la somiglianza con i nomi delle modalità di orientamento della piattaforma iOS.

Per impostazione predefinita, l'orientamento dello schermo di configurazione è in portrait modalità e la schermata chiamante è in allButUpsideDown modalità. Per impostare un orientamento diverso per le schermate, è possibile passare OrientationOptions. Per impostazione predefinita, la libreria dell'interfaccia utente include un set di OrientationOptions tipi utilizzabili con il composito.

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

Passaggi successivi

• Altre informazioni sulla libreria dell'interfaccia utente