在應用程式中設定畫面方向
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。 下列範例會為設定畫面設定 FULL_SENSOR，並且為複合元件的通話畫面設定 LANDSCAPE。
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)