iOS / iPadOS 向けガイド¶

Info.plist の用途説明¶

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

ランタイム権限のリクエスト¶

Dart 側の実装例として permission_handler パッケージを使うと、次のように権限を確保できます。

import 'package:permission_handler/permission_handler.dart';

// 必要な権限のみユーザーにリクエストする
Future<bool> ensureMediaPermissions({
  required bool needsCamera,
  required bool needsMicrophone,
}) async {
  // 配信内容に応じて要求する権限を組み立てる
  final permissions = <Permission>[
    if (needsCamera) Permission.camera,
    if (needsMicrophone) Permission.microphone,
  ];
  // 要求する権限がなければそのまま許可扱い
  if (permissions.isEmpty) {
    return true;
  }
  // ダイアログを表示し、すべての権限が許可されたかを返す
  final statuses = await permissions.request();
  return statuses.values.every((status) => status.isGranted);
}

接続前に次のように呼び出します。

// カメラとマイクの権限をリクエストする
final granted = await ensureMediaPermissions(
  needsCamera: true,
  needsMicrophone: true,
);
// いずれかの権限が拒否された場合は接続せずに終了する
if (!granted) {
  return;
}
// 権限が揃ってからメディアを取得する
final stream = await MediaDevices.getUserMedia(
  const GetUserMediaOptions(audio: true, video: true),
);
await client.connect(stream);

MethodChannel とネイティブ実装を組み合わせて権限を扱う場合は、 sora_sdk/devtools/ios/Runner/AppDelegate.swift と sora_sdk/devtools/lib/main.dart の _ensureMediaPermissions を参考にしてください。

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

ローカル映像は、 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!)