Festlegen der Bildschirmausrichtung in einer Anwendung

Mit der Azure Communication Services-Benutzeroberflächenbibliothek können Entwickler die Ausrichtung von Bildschirmen in einer Anwendung festlegen. Sie können den Bildschirmausrichtungsmodus auf dem Anrufeinrichtungsbildschirm und auf dem Anrufbildschirm der UI-Bibliothek angeben.

Voraussetzungen

• Ein Azure-Konto mit einem aktiven Abonnement. Sie können kostenlos ein Konto erstellen.
• Eine bereitgestellte Communication Services-Ressource. Erstellen Sie eine Communication Services-Ressource.
• Ein Benutzerzugriffstoken zum Aktivieren des Anrufclients. Rufen Sie ein Benutzerzugriffstoken ab.
• Optional: Abschluss der Schnellstartanleitung für die ersten Schritte mit den Verbundelementen der UI-Bibliothek.

Festlegen der Bildschirmausrichtung

Weitere Informationen finden Sie in der Open Source Android UI Library und im Beispielanwendungscode.

Verfügbare Ausrichtungen

In der folgenden Tabelle sind CallCompositeSupportedScreenOrientation typen für out-of-the-box orientations aufgeführt. Wenn Sie die Ausrichtung der verschiedenen Bildschirme des Zusammengesetzts festlegen möchten, legen Sie diesen CallCompositeSupportedScreenOrientation auf CallComposite.

Ausrichtungsmodus	CallCompositeSupportedScreenOrientation-Typ
PORTRAIT	CallCompositeSupportedScreenOrientation.PORTRAIT
LANDSCAPE	CallCompositeSupportedScreenOrientation.LANDSCAPE
REVERSE_LANDSCAPE	CallCompositeSupportedScreenOrientation.REVERSE_LANDSCAPE
USER_LANDSCAPE	CallCompositeSupportedScreenOrientation.USER_LANDSCAPE
FULL_SENSOR	CallCompositeSupportedScreenOrientation.FULL_SENSOR
USER	CallCompositeSupportedScreenOrientation.USER

Ausrichtungs-API

CallCompositeSupportedScreenOrientation ist ein benutzerdefinierter Typ für die Android-Benutzeroberflächenbibliothek. Der Name für den Ausrichtungstyp wird definiert, indem die Ähnlichkeit mit den Namen der Ausrichtungsmodi der Android-Plattform beibehalten wird.

Standardmäßig befindet sich die Bildschirmausrichtung des Setups im PORTRAIT Modus, und der Aufrufende Bildschirm befindet sich im USER Modus. Um eine andere Ausrichtung für die Bildschirme festzulegen, können Sie übergeben CallCompositeSupportedScreenOrientation. Standardmäßig enthält die Ui-Bibliothek eine Reihe von CallCompositeSupportedScreenOrientation Typen, die mit dem Zusammengesetzten verwendet werden können.

Sie können auch eine Liste von CallCompositeSupportedScreenOrientation Typen mithilfe der statischen Funktion CallCompositeSupportedScreenOrientation.values()abrufen.

Um die Ausrichtung festzulegen, geben Sie sie an CallCompositeSupportedScreenOrientation und übergeben sie an CallCompositeBuilder. Im folgenden Beispiel wird der Setupbildschirm und LANDSCAPE der Aufrufbildschirm des Zusammengesetzten festgelegtFULL_SENSOR.

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

Weitere Informationen finden Sie in der Open-Source-iOS-UI-Bibliothek und im Beispielanwendungscode.

Verfügbare Ausrichtungen

In der folgenden Tabelle sind OrientationOptions typen für out-of-the-box orientations aufgeführt. Wenn Sie die Ausrichtung der verschiedenen Bildschirme des Zusammengesetzts festlegen möchten, legen Sie diesen OrientationOptions auf CallComposite.

Ausrichtungsmodus	OrientationOptions-Typ
portrait	OrientationOptions.portrait
landscape	OrientationOptions.landscape
landscapeRight	OrientationOptions.landscapeRight
landscapeLeft	OrientationOptions.landscapeLeft
allButUpsideDown	OrientationOptions.allButUpsideDown

Ausrichtungs-API

OrientationOptions ist ein benutzerdefinierter Typ für die iOS-Ui-Bibliothek. Der Name für den Ausrichtungstyp wird definiert, indem die Ähnlichkeit mit den Namen der Ausrichtungsmodi der iOS-Plattform beibehalten wird.

Standardmäßig befindet sich die Bildschirmausrichtung des Setups im portrait Modus, und der Aufrufende Bildschirm befindet sich im allButUpsideDown Modus. Um eine andere Ausrichtung für die Bildschirme festzulegen, können Sie übergeben OrientationOptions. Standardmäßig enthält die Ui-Bibliothek eine Reihe von OrientationOptions Typen, die mit dem Zusammengesetzten verwendet werden können.

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

Nächste Schritte

• Weitere Informationen zur UI-Bibliothek