在應用程式中開啟圖片

當使用者在通話時，全螢幕UI可以防止使用者在應用程式中進行多任務處理。 有兩種方式可讓使用者在應用程式中執行多任務：

• 讓用戶選取 [上一頁 ] 按鈕，並返回上一個畫面。 當使用者仍在呼叫時，不會顯示呼叫UI。
• 開啟圖片中。

本文說明如何在 Azure 通訊服務 UI 連結庫中開啟圖片。 圖片內功能是系統提供的，且受限於裝置上的功能支援，包括CPU負載、RAM 可用性和電池狀態。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 已部署通訊服務資源。 建立通訊服務資源。
• 使用者存取令牌，可啟用呼叫用戶端。 取得使用者存取令牌。
• 選擇性：完成 快速入門以開始使用UI連結庫複合。

開啟功能

如需詳細資訊，請參閱 開放原始碼 Android UI 連結庫 和 範例應用程式程式代碼。

圖片內設定

若要啟用多任務和圖片中，請使用 CallCompositeBuilder.multitasking 來設定 CallCompositeMultitaskingOptions 和 enableMultitasking enableSystemPictureInPictureWhenMultitasking 建構函式參數。

Kotlin

val callComposite: CallComposite =
            CallCompositeBuilder()
            .multitasking(CallCompositeMultitaskingOptions(true, true))
            .build()

Java

CallComposite callComposite = 
    new CallCompositeBuilder()
        .multitasking(new CallCompositeMultitaskingOptions(true, true))
        .build();

當 設定為 true時enableMultitasking，[上一頁] 按鈕隨即出現。

當使用者點選 [返回] 按鈕 [呼叫 UI] 時，如果已設定，則會顯示 [圖片中的圖片] 檢視。

當 多任務為 ON 時 CallComposite，呼叫活動會在專用的工作中啟動。 在工作歷程記錄中，使用者會看到兩個畫面：一個用於應用程式的活動，另一個用於通訊服務呼叫活動。

---

若要以程式設計方式輸入多任務，如果設定顯示圖片中的圖片，請呼叫 sendToBackground 方法。

Kotlin

callComposite.sendToBackground()

Java

callComposite.sendToBackground();

若要以程式設計方式讓使用者回到呼叫活動，請使用 bringToForeground 函式：

Kotlin

callComposite.bringToForeground(context)

Java

callComposite.bringToForeground(context);

如需詳細資訊，請參閱 開放原始碼 iOS UI 連結庫 和 範例應用程式程式代碼。

圖片內設定

若要開啟多工作處理和圖片中，請使用建 CallCompositeOptions 構函式參數 enableMultitasking 和 enableSystemPiPWhenMultitasking。

注意

具有早於 iOS 16 之部署目標的應用程式需要 com.apple.developer.avfoundation multitasking-camera-access 權利，才能在圖片中模式中使用相機。

let callCompositeOptions = CallCompositeOptions(
            enableMultitasking: true,
            enableSystemPictureInPictureWhenMultitasking: true)

let callComposite = CallComposite(withOptions: callCompositeOptions)

當 設定為 true時enableMultitasking，[上一頁] 按鈕隨即出現。

當使用者點選 [返回] 按鈕 [呼叫 UI] 時，如果已設定，則會顯示 [圖片中的圖片] 檢視。

---

若要以程式設計方式輸入或結束多工作處理，請使用 isHidden 屬性：

// Close calling UI and display PiP
callComposite.isHidden = true

// Displaye calling UI and close PiP
callComposite.isHidden = false

下一步

• 深入瞭解UI連結庫