將 TelecomManager 整合到 UI 程式庫

Azure 通訊服務 UI 程式庫提供現成的 TelecomManager 支援。 開發人員可提供其本身的設定，讓 TelecomManager 用於 UI 程式庫。

在本文中，您將了解如何在應用程式中使用 UI 程式庫正確設定 TelecomManager。

必要條件

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 已部署通訊服務資源。 建立通訊服務資源。
• 用來啟用通話用戶端的使用者存取權杖。 取得使用者存取權杖。
• 選擇性：完成開始使用 UI 程式庫複合元件的快速入門。

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

設定 TelecomManager 整合

Azure 通訊服務呼叫 SDK 支援 TelecomManager 整合。 您可以藉由設定 CallCompositeTelecomManagerOptions 的執行個體，在 UI 程式庫中啟用此整合。 如需詳細資訊，請參閱與 TelecomManager 整合 (部分機器翻譯)。

CallCompositeTelecomManagerIntegrationMode 提供 SDK_PROVIDED_TELECOM_MANAGER 和 APPLICATION_IMPLEMENTED_TELECOM_MANAGER 的選項。 SDK_PROVIDED_TELECOM_MANAGER 需要 phoneAccountId，並使用呼叫 SDK 的實作。 APPLICATION_IMPLEMENTED_TELECOM_MANAGER 適用於 TelecomManager 已整合在應用程式中的情況。

Kotlin

    val callComposite: CallComposite = CallCompositeBuilder()
        .telecomManagerOptions(CallCompositeTelecomManagerOptions(
            CallCompositeTelecomManagerIntegrationMode.SDK_PROVIDED_TELECOM_MANAGER,
            "app_id"
        )).build()

Java

    CallComposite callComposite = new CallCompositeBuilder()
        .telecomManagerOptions(new CallCompositeTelecomManagerOptions(
                CallCompositeTelecomManagerIntegrationMode.SDK_PROVIDED_TELECOM_MANAGER,
                "PHONE_ACCOUNT_ID"
        )).build();

保留和繼續 API

針對 APPLICATION_IMPLEMENTED_TELECOM_MANAGER 使用 hold 和 resume 來管理呼叫狀態。

Kotlin

    callComposite.hold()?.whenComplete { _, error ->  }
    callComposite.resume()?.whenComplete { _, error ->  }

Java

    callComposite.hold().whenComplete((aVoid, throwable) -> {
            // Handle error
        });

    callComposite.resume().whenComplete((aVoid, throwable) -> {
            // Handle error
        });

下一步

• 深入了解 UI 程式庫