TelecomManager を UI ライブラリに統合する

Azure Communication Services の UI ライブラリを使用すると、TelecomManager をすぐにサポートできます。 開発者は、UI ライブラリで使用される TelecomManager 用の独自の構成を提供できます。

この記事では、アプリケーションで UI ライブラリを使用して TelecomManager を正しく設定する方法について説明します。

前提条件

• アクティブなサブスクリプションが含まれる Azure アカウント。 無料でアカウントを作成できます。
• デプロイ済みの Communication Services リソース。 Communication Services リソースを作成します。
• 通話クライアントを有効にするためのユーザー アクセス トークン。 ユーザー アクセス トークンを取得します。
• 省略可能: UI ライブラリの複合の概要に関するクイックスタートを完了します。

詳細については、オープンソースの Android UI ライブラリ とサンプル アプリケーション コードを参照してください。

TelecomManager の統合を設定する

Azure Communication Services Calling SDK では、TelecomManager の統合がサポートされています。 UI ライブラリでこの統合を有効にするには、CallCompositeTelecomManagerOptions のインスタンスを構成します。 詳細については、「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 ライブラリの詳細情報