Ustawianie orientacji ekranu w aplikacji

Biblioteka interfejsu użytkownika usług Azure Communication Services umożliwia deweloperom ustawianie orientacji ekranów w aplikacji. Tryb orientacji ekranu można określić na ekranie konfiguracji wywołania i na ekranie wywołania biblioteki interfejsu użytkownika.

Wymagania wstępne

• Konto platformy Azure z aktywną subskrypcją. Utwórz konto bezpłatnie.
• Wdrożony zasób usług komunikacyjnych. Utwórz zasób usług komunikacyjnych.
• Token dostępu użytkownika umożliwiający włączenie klienta wywołania. Uzyskiwanie tokenu dostępu użytkownika.
• Opcjonalnie: ukończenie przewodnika Szybki start dotyczącego rozpoczynania pracy z zestawami biblioteki interfejsu użytkownika.

Ustawianie orientacji ekranu

Aby uzyskać więcej informacji, zobacz bibliotekę interfejsu użytkownika systemu Android typu open source i przykładowy kod aplikacji.

Dostępne orientacje

W poniższej tabeli wymieniono CallCompositeSupportedScreenOrientation typy orientacji gotowej do użycia. Jeśli chcesz ustawić orientację różnych ekranów złożonego, ustaw wartość CallCompositeSupportedScreenOrientation CallComposite.

Tryb orientacji	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

Interfejs API orientacji

CallCompositeSupportedScreenOrientation jest typem niestandardowym biblioteki interfejsu użytkownika systemu Android. Nazwa typu orientacji jest definiowana przez zachowanie podobieństwa z nazwami trybów orientacji platformy Android.

Domyślnie orientacja ekranu konfiguracji jest w PORTRAIT trybie, a ekran wywołujący jest w USER trybie. Aby ustawić inną orientację dla ekranów, możesz przekazać CallCompositeSupportedScreenOrientationpolecenie . Poza polem biblioteka interfejsu użytkownika zawiera zestaw CallCompositeSupportedScreenOrientation typów, które mogą być używane w zestawie złożonym.

Listę typów można również uzyskać CallCompositeSupportedScreenOrientation przy użyciu funkcji CallCompositeSupportedScreenOrientation.values()statycznej .

Aby ustawić orientację, określ CallCompositeSupportedScreenOrientation i przekaż ją do CallCompositeBuilder. W poniższym przykładzie ustawiono FULL_SENSOR ekran konfiguracji i LANDSCAPE ekran wywołania złożonego.

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

Aby uzyskać więcej informacji, zobacz bibliotekę interfejsu użytkownika systemu iOS typu open source i przykładowy kod aplikacji.

Dostępne orientacje

W poniższej tabeli wymieniono OrientationOptions typy orientacji gotowej do użycia. Jeśli chcesz ustawić orientację różnych ekranów złożonego, ustaw wartość OrientationOptions CallComposite.

Tryb orientacji	Typ OrientationOptions
portrait	OrientationOptions.portrait
landscape	OrientationOptions.landscape
landscapeRight	OrientationOptions.landscapeRight
landscapeLeft	OrientationOptions.landscapeLeft
allButUpsideDown	OrientationOptions.allButUpsideDown

Interfejs API orientacji

OrientationOptions jest typem niestandardowym biblioteki interfejsu użytkownika systemu iOS. Nazwa typu orientacji jest definiowana przez zachowanie podobieństwa z nazwami trybów orientacji platformy iOS.

Domyślnie orientacja ekranu konfiguracji jest w portrait trybie, a ekran wywołujący jest w allButUpsideDown trybie. Aby ustawić inną orientację dla ekranów, możesz przekazać OrientationOptionspolecenie . Poza polem biblioteka interfejsu użytkownika zawiera zestaw OrientationOptions typów, które mogą być używane w zestawie złożonym.

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

Następne kroki

• Dowiedz się więcej o bibliotece interfejsu użytkownika