你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
在应用程序中设置屏幕方向
Azure 通信服务 UI 库使开发人员能够在应用程序中设置屏幕的方向。 可以在呼叫设置屏幕上和 UI 库的呼叫屏幕上指定屏幕方向模式。
先决条件
- 具有活动订阅的 Azure 帐户。 免费创建帐户。
- 已部署的通信服务资源。 创建通信服务资源。
- 用于启用通话客户端的用户访问令牌。 获取用户访问令牌。
- 可选：完成 快速入门以开始使用 UI 库复合。
设置屏幕方向
有关详细信息，请参阅 开源 Android UI 库 和 示例应用程序代码。
可用方向
下表列出了 CallCompositeSupportedScreenOrientation 开箱即用方向的类型。 如果要设置复合的各个屏幕的方向，请设置为 CallCompositeSupportedScreenOrientation CallComposite。
| 方向模式 | 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
CallCompositeSupportedScreenOrientation 是 Android UI 库的自定义类型。 方向类型的名称通过保留与 Android 平台的方向模式的名称保持相似性来定义。
默认情况下，设置屏幕方向处于 PORTRAIT 模式，呼叫屏幕处于 USER 模式。 若要为屏幕设置不同的方向，可以传递 CallCompositeSupportedScreenOrientation。 现身即用的 UI 库包含一组 CallCompositeSupportedScreenOrientation 可用于复合的类型。
还可以使用静态函数CallCompositeSupportedScreenOrientation.values()获取类型的列表CallCompositeSupportedScreenOrientation。
若要设置方向，请指定 CallCompositeSupportedScreenOrientation 并将其传递给 CallCompositeBuilder。 以下示例为设置屏幕和LANDSCAPE复合的调用屏幕设置FULL_SENSOR。
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()
有关详细信息，请参阅 开源 iOS UI 库 和 示例应用程序代码。
可用方向
下表列出了 OrientationOptions 开箱即用方向的类型。 如果要设置复合的各个屏幕的方向，请设置为 OrientationOptions CallComposite。
| 方向模式 | OrientationOptions 类型 |
|---|---|
portrait |
OrientationOptions.portrait |
landscape |
OrientationOptions.landscape |
landscapeRight |
OrientationOptions.landscapeRight |
landscapeLeft |
OrientationOptions.landscapeLeft |
allButUpsideDown |
OrientationOptions.allButUpsideDown |
方向 API
OrientationOptions 是 iOS UI 库的自定义类型。 方向类型的名称通过保留 iOS 平台的方向模式的名称来定义相似性。
默认情况下，设置屏幕方向处于 portrait 模式，呼叫屏幕处于 allButUpsideDown 模式。 若要为屏幕设置不同的方向，可以传递 OrientationOptions。 现身即用的 UI 库包含一组 OrientationOptions 可用于复合的类型。
let callCompositeOptions = CallCompositeOptions(localization: localizationConfig,
setupScreenOrientation: OrientationOptions.portrait,
callingScreenOrientation: OrientationOptions.allButUpsideDown)
let callComposite = CallComposite(withOptions: callCompositeOptions)