Ange skärmorientering i ett program
Med Användargränssnittsbiblioteket för Azure Communication Services kan utvecklare ange orienteringen för skärmar i ett program. Du kan ange skärmorienteringsläge på samtalskonfigurationsskärmen och på samtalsskärmen i användargränssnittsbiblioteket.
Förutsättningar
- Ett Azure-konto med en aktiv prenumeration. Skapa ett konto utan kostnad.
- En distribuerad Communication Services-resurs. Skapa en Communication Services-resurs.
- En användaråtkomsttoken för att aktivera anropsklienten. Hämta en användaråtkomsttoken.
- Valfritt: Slutförande av snabbstarten för att komma igång med kompositerna för gränssnittsbiblioteket.
Ange skärmorientering
Mer information finns i Android UI-biblioteket med öppen källkod och exempelprogramkoden.
Tillgängliga orienteringar
I följande tabell visas CallCompositeSupportedScreenOrientation typer för färdiga orienteringar. Om du vill ange orienteringen för de olika skärmarna i kompositen anger du CallCompositeSupportedScreenOrientation till CallComposite.
| Orienteringsläge | 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 |
Api för orientering
CallCompositeSupportedScreenOrientation är en anpassad typ för Android UI-biblioteket. Namnet på orienteringstypen definieras genom att likheten med namnen på Android-plattformens orienteringslägen bevaras.
Som standard är installationsskärmens orientering i PORTRAIT läge och samtalsskärmen är i USER läge. Om du vill ange en annan orientering för skärmarna kan du skicka CallCompositeSupportedScreenOrientation. Användargränssnittsbiblioteket innehåller en uppsättning CallCompositeSupportedScreenOrientation typer som kan användas med det sammansatta objektet.
Du kan också hämta en lista över CallCompositeSupportedScreenOrientation typer med hjälp av den statiska funktionen CallCompositeSupportedScreenOrientation.values().
Om du vill ange orienteringen anger CallCompositeSupportedScreenOrientation och skickar du den till CallCompositeBuilder. I följande exempel anges FULL_SENSOR för installationsskärmen och LANDSCAPE för den sammansatta skärmens samtalsskärm.
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()
Mer information finns i iOS-användargränssnittsbiblioteket med öppen källkod och exempelprogramkoden.
Tillgängliga orienteringar
I följande tabell visas OrientationOptions typer för färdiga orienteringar. Om du vill ange orienteringen för de olika skärmarna i kompositen anger du OrientationOptions till CallComposite.
| Orienteringsläge | Typ av OrientationOptions |
|---|---|
portrait |
OrientationOptions.portrait |
landscape |
OrientationOptions.landscape |
landscapeRight |
OrientationOptions.landscapeRight |
landscapeLeft |
OrientationOptions.landscapeLeft |
allButUpsideDown |
OrientationOptions.allButUpsideDown |
Api för orientering
OrientationOptions är en anpassad typ för iOS-användargränssnittsbiblioteket. Namnet på orienteringstypen definieras genom att likheten med namnen på iOS-plattformens orienteringslägen bevaras.
Som standard är installationsskärmens orientering i portrait läge och samtalsskärmen är i allButUpsideDown läge. Om du vill ange en annan orientering för skärmarna kan du skicka OrientationOptions. Användargränssnittsbiblioteket innehåller en uppsättning OrientationOptions typer som kan användas med det sammansatta objektet.
let callCompositeOptions = CallCompositeOptions(localization: localizationConfig,
setupScreenOrientation: OrientationOptions.portrait,
callingScreenOrientation: OrientationOptions.allButUpsideDown)
let callComposite = CallComposite(withOptions: callCompositeOptions)