macOS 向けガイド¶

Info.plist の用途説明¶

<key>NSCameraUsageDescription</key>
<string>カメラを利用する目的を記述します</string>
<key>NSMicrophoneUsageDescription</key>
<string>マイクを利用する目的を記述します</string>

Entitlements の設定¶

App Sandbox を有効にしている場合はカメラとマイクの Entitlement を追加してください。 DebugProfile.entitlements と Release.entitlements の両方に設定する必要があります。

<key>com.apple.security.device.camera</key>
<true/>
<key>com.apple.security.device.audio-input</key>
<true/>

また、 Sora への接続には com.apple.security.network.client が必要です。

<key>com.apple.security.network.client</key>
<true/>

ローカル映像のレンダリング¶

ローカル映像は、 MediaDevices.getUserMedia() で取得した LocalVideoTrack から textureId を取り出して Texture に渡すことでレンダリングできます。接続前のカメラプレビューもこの方法で行えます。

// カメラ・マイクから LocalMediaStream を取得する
final stream = await MediaDevices.getUserMedia(
  const GetUserMediaOptions(audio: true, video: true),
);

// 映像トラックから textureId を取得する
final videoTrack = stream.getVideoTracks().first;
final localTextureId = await videoTrack.textureId;

// 取得した textureId を Flutter の Texture に渡してレンダリングする
Texture(textureId: localTextureId)

接続は任意のタイミングで行います。

// Sora に接続して配信を開始する
await client.connect(stream);

リモート映像のレンダリング¶

接続相手から受信した映像は client.events の SoraTrackEvent で通知されます。 track.kind が 'video' のとき、 track.textureId を Texture に渡してレンダリングします。

// 接続相手の映像トラック追加イベントを受け取る
client.events.listen((event) {
  // 映像トラックのときだけ textureId を保持する
  if (event case SoraTrackEvent(:final track) when track.kind == 'video') {
    setState(() {
      remoteTextureId = track.textureId;
    });
  }
});

// 受け取った textureId を Flutter の Texture に渡してレンダリングする
Texture(textureId: remoteTextureId!)