2026.3.x から 2026.4.x への移行¶

概要¶

2026.4.0 の Package.swift は swift-tools-version が 6.3 で、 swiftLanguageModes: [.v6] により Swift 6 言語モードを宣言しています。 そのため Swift Package Manager で取り込んだ場合も SDK は Swift 6 言語モードでコンパイルされます。利用側で言語モードを指定する必要はありません。

swift-tools-version 6.3 の manifest を読むために Swift Package Manager 6.3 以降が必要です。 Swift Package Manager 6.3 は Xcode 26.6 に同梱されているため、 2026.4.0 以降を利用するには Xcode 26.6 以降が必要です。

利用側で必要な対応¶

SDK 側で公開型に Sendable 準拠を追加したため、利用側で独自に Sendable 準拠を追加していた場合は削除してください。 重複適合は警告になり、 warnings-as-errors を有効にした build ではエラーになります。

Configuration / MediaChannel / MediaStream / MediaChannelHandlers / SoraHandlers / Statistics / VideoView などは Sendable ではありません。 これらの値を actor 境界や Task の @Sendable クロージャへそのまま渡すことはできません。詳細は nonisolated(unsafe) が必要なケース をご確認ください。

@MainActor のクラス ( UIViewController など) の中でコールバッククロージャを書くと、クロージャが MainActor 隔離を継承します。 SDK はシグナリングスレッドなどからコールバックを呼ぶため、そのままでは Swift 6 言語モードの実行時隔離チェックでクラッシュします。 クロージャに @Sendable を付けるか、 nonisolated な関数へ処理を分離して隔離を外してください。

config.mediaChannelHandlers.onAddStream = { @Sendable [weak self] stream in
  // MediaStream は非 Sendable のため nonisolated(unsafe) で Task へ渡す
  nonisolated(unsafe) let stream = stream
  Task { @MainActor in
    guard let self else { return }
    self.attach(stream: stream)
  }
}

コールバックの呼び出しスレッドは保証されないため、 UI の更新は main actor / main queue へ束ねてください。

MediaChannel.setVideoHardMute など一部の API は async / await に対応しています。 これらは MediaChannel を保持している側のコンテキストから Task で局所的に呼び出す想定です。

nonisolated(unsafe) が必要なケース¶

2026.4.0 の時点では、次の操作を行う場合にアプリ側で nonisolated(unsafe) が必要です。

• SDK のコールバックで受け取った MediaChannel / MediaStream を Task や @Sendable クロージャへ渡す
  • 例: Sora.connect の handler で受け取った MediaChannel を Task { @MainActor in ... } へ渡す
• @MainActor の文脈から MediaChannel の async メソッドを呼び出す
  • rpc
  • sendableRPC
  • getStatsSnapshot()
  • setVideoHardMute(_:)
  • startScreenCapture(settings:)
  • stopScreenCapture()
• @MainActor の文脈から ScreenCaptureSettings を startScreenCapture(settings:) へ渡す

MediaChannel / MediaStream / ScreenCaptureSettings は Sendable ではないためです。 また MediaChannel の async メソッドは nonisolated な非同期メソッドで、呼び出し元の executor では実行されません (コンパイラの診断では @concurrent と表示されます) 。 そのため @MainActor の文脈から呼び出すと、 MediaChannel の参照と引数が actor 境界を越えます。

nonisolated(unsafe) を付けた let で受けると、この検査を外せます。

@MainActor
final class RoomViewController: UIViewController {
  private var mediaChannel: MediaChannel?

  func setHardMute(_ mute: Bool) {
    guard let mediaChannel else { return }
    // MediaChannel は非 Sendable で、 setVideoHardMute は呼び出し元の executor では実行されないため
    nonisolated(unsafe) let channel = mediaChannel
    Task {
      do {
        try await channel.setVideoHardMute(mute)
      } catch {
        print(error)
      }
    }
  }
}

MediaChannel / MediaStream の参照を actor 境界へ渡す必要がある箇所は、 2026.4.0 で追加した Sendable な API へ置き換えることで減らせます。 Sendable な API への移行 をご確認ください。

Sendable な API への移行¶

actor 境界や @Sendable クロージャへ値を渡す場合は、 2026.4.0 で追加した次の API を利用してください。

• RPC: MediaChannel.sendableRPC
  • 詳細は Swift 6 言語モードに対応する Sendable な RPC を利用する をご確認ください
• 統計情報: MediaChannel.getStatsSnapshot(handler:) / MediaChannel.getStatsSnapshot()
  • 詳細は Swift 6 言語モードに対応する Sendable な統計情報を取得する をご確認ください
• イベント購読: Sora.subscribeEvents(bufferingPolicy:) / MediaChannel.subscribeEvents(bufferingPolicy:)
  • 詳細は Swift 6 言語モードに対応する Sendable なイベントを購読する をご確認ください
• 任意の JSON: JSONValue
  • 詳細は 任意の JSON を送受信する をご確認ください

MediaChannel.rpc / MediaChannel.getStats(handler:) とコールバック API は引き続き利用できます。 コールバックの型は変更していませんが、一部のコールバックは配送 executor が変わっています。詳細は リリースノート をご確認ください。

MediaChannel.rpc は互換 API として残していますが、将来のバージョンで削除される予定です。 RPC を actor 境界や @Sendable クロージャへ渡す場合は MediaChannel.sendableRPC へ移行してください。

RPCErrorDetail.data の型変更¶

// 移行前
if let errorData = detail.data as? [String: Any] {
  _ = errorData
}

// 移行後
if case .some(.object(let errorData)) = detail.data {
  _ = errorData
}

WebRTC の enum 型への CustomStringConvertible 準拠の削除¶

// 移行前
print(state.description)

// 移行後 (raw value を利用する)
print(state.rawValue)

概要¶

Utilities.Stopwatch を非推奨にしました。 1 秒ごとに経過時間を "時:分:秒" の文字列で handler へ通知するカウンタで、 Sora iOS SDK 固有の機能ではなく SDK 内でも利用していないため、 2027 年中に廃止予定です。

移行方法¶

1 秒ごとの定期実行や表示の更新には、 Timer を MainActor 上のタイマーとして管理する方法か、 ContinuousClock と Task.sleep(for:) を組み合わせる方法へ移行してください。

経過時間の計測だけが目的の場合は、 ContinuousClock / SuspendingClock の now の差分 ( Duration ) へ移行してください。

用途によって移行先が異なるため、 SDK 固有の代替タイマーは提供しません。

概要¶

Utilities.randomString を非推奨にしました。 紛らわしい文字 ( l / I / O) を除く 59 文字の英数字から length の長さの文字列を返す汎用ユーティリティで、 Sora iOS SDK 固有の機能ではなく SDK 内でも利用していないため、 2027 年中に廃止予定です。 シグネチャと挙動は変わりません。

移行方法¶

ランダムな文字列が必要な場合は、 UUID や標準の乱数 API ( randomElement() / UInt32.random(in:) など) へ移行してください。 Utilities.randomString とは出力の長さ指定と文字集合が異なるため、同じ出力が必要な場合は文字集合を自前で定義してください。

用途によって移行先が異なるため、 SDK 固有の代替ユーティリティは提供しません。