1対1音声通話

1対1音声通話を実装するサンプルコードです。

前提条件

開始する前に、次の作業が必要です。

• PlanetKitを初期化してください。
• 適切なアクセストークンを取得してください。
• 1対1通話フローにて、APIを使用するための全般的なプロセスを確認してください。

1対1音声通話実装時の考慮事項

受信者側で通話の通知を受けるには、通知用システムを実装するか、APNs（Apple Push Notification service）またはFCM（Firebase Cloud Messaging）といった外部プッシュ通知システムを連携する必要があります。

また、受信者にどのような情報を伝えるべきかを知っておく必要があります。アプリサーバーの役割でアプリケーションが転送すべきデータであるcc_paramについて確認できます。

makeCall()またはverifyCall()を呼び出した後は、返されたPlanetKitMakeCallResultまたはPlanetKitVerifyCallResultのreasonのプロパティを確認する必要があります。

• reasonがPlanetKitStartFailReason.NONEの場合、成功を意味します。
• それ以外は失敗を意味し、reasonに応じて適切に処理する必要があります。

デバイス権限のリクエスト

Dart permission_handlerパッケージを使って、電話およびマイクの権限をリクエストします。

import 'package:permission_handler/permission_handler.dart';
final status = await [Permission.microphone, Permission.phone, Permission.bluetoothConnect].request();

変数準備

主要プロパティとイベントハンドラーに対する変数を準備します。

• PlanetKitCallEventHandlerは、1対1通話のステータス変更イベントを処理するのに使用されます。詳しくは、1対1通話フローを参照してください。
• PlanetKitMyMediaStatusHandlerは、ローカルユーザーのメディアステータス変更イベントを処理するために使用されます。マイクがミュートもしくはミュート解除された場合、またはオーディオの説明が更新された場合など、イベントに基づいてローカルユーザーのUIを更新できます。

final String _myUserId = "test user id";
final String _serviceId = "test service id";
PlanetKitCall? _call;

final _eventHandler = PlanetKitCallEventHandler(
    onWaitConnected: (call) => print("wait connected"),
    onVerified: (call, peerUseResponderPreparation) => print("verified"),
    onConnected: (call, isInResponderPreparation, shouldFinishPreparation) => print("connected"),
    onDisconnected: (call, reason, source, byRemote) => print("disconnected $reason"));

final _myMediaStatusHandler = PlanetKitMyMediaStatusHandler(
    onMicMute: (status) => print("mic muted"),
    onMicUnmute: (status) => print("mic unmuted"),
    onAudioDescriptionUpdate: (status, averageVolumeLevel) => print("audio description updated"));

通話作成（発信側）

通話を作成するには、適切なPlanetKitMakeCallParamと共にPlanetKitManager.instance.makeCall()を呼び出します。PlanetKitMakeCallParamを作成するには、PlanetKitMakeCallParamBuilder()を使用します。

Future<bool> makeCall(String peerId, String accessToken) async {
  final builder = PlanetKitMakeCallParamBuilder()
      .setMyUserId(_myUserId)
      .setMyServiceId(_serviceId)
      .setPeerUserId(peerId)
      .setPeerServiceId(_serviceId)
      .setAccessToken(accessToken);

  PlanetKitMakeCallParam? param;
  try {
    param = builder.build();
  } catch (error) {
    print("failed to build make call param $error");
    return false;
  }

  final result = await PlanetKitManager.instance.makeCall(param, _eventHandler);

  if (result.reason != PlanetKitStartFailReason.none) {
    print("make call failed. reason: $result.reason");
    return false;
  }

  // Store call instance and set MyMediaStatusHandler.
  _call = result.call;
  _call?.myMediaStatus.setHandler(_myMediaStatusHandler);
  return true;
}

通話の受信（受信側）

アプリサーバーからプッシュメッセージを受信したら、メッセージからcc_paramをパーシングしてccParamを生成する必要があります。このデータは、通話を受信する際に渡すべき必須引数です。

通話を受信するには、適切なPlanetKitVerifyCallParamと共にPlanetKitManager.instance.verifyCall()を呼び出します。PlanetKitVerifyCallParamを作成するには、PlanetKitVerifyCallParamBuilder()を使用します。

Future<bool> verifyCall(String ccParamString) async {
  final ccParam = await PlanetKitCcParam.createCcParam(ccParamString);
  if (ccParam == null) {
    print("failed to create ccparam string $ccParamString");
    return false;
  }

  final builder = PlanetKitVerifyCallParamBuilder()
      .setMyUserId(_myUserId)
      .setMyServiceId(_serviceId)
      .setCcParam(ccParam);

  PlanetKitVerifyCallParam? param;
  try {
    param = builder.build();
  } catch (error) {
    print("failed to build verify call param $error");
    return false;
  }

  final result =
      await PlanetKitManager.instance.verifyCall(param, _eventHandler);

  if (result.reason != PlanetKitStartFailReason.none) {
    print("make call result $result.reason");
    return false;
  }

  // Store call instance and set MyMediaStatusHandler.
  _call = result.call;
  _call?.myMediaStatus.setHandler(_myMediaStatusHandler);
  return true;
}

通話の応答（受信側）

一般的に通話を受信した後、通話を受信するかどうかを決める時間が必要です。通話に応答するには、PlanetKitCall.acceptCall()を呼び出します。

Tip

_call変数は、verifyCall()で検証されたPlanetKitCallのインスタンスです。

Future<void> acceptCall() async {
  return await _call?.acceptCall() ?? false;
}

通話の切断

通話を切断するには、endCall()を呼び出します。

Future<bool> endCall() async {
  return await _call?.endCall() ?? false;
}

CallKit連携のための追加実装（任意）

Note

この手順は、iOSアプリケーションにのみ適用されます。

CallKitフレームワークを使用する場合、PlanetKitMakeCallParamおよびPlanetKitVerifyCallParamでcallKitTypeをPlanetKitCallKitType.userに設定する必要があります。

次に、CXProviderDelegate.provider(_ provider: CXProvider, didActivate audioSession: AVAudioSession)でPlanetKitCall.notifyCallKitAudioActivation()を呼び出し、PlanetKitでオーディオを有効にする必要があります。

関連サンプルコード

• PlanetKitの初期化
• 1対1ビデオ通話

関連ドキュメント

• アクセストークン
• 1対1通話フロー
• アプリサーバーの役割