リリースノート¶

• 詳細は 統計情報 をご確認ください

• 詳細は SDK 内部で CameraVideoCapturer を管理する をご確認ください

• Sora Android SDK 2025.3.0 ではハードミュートには setAudioRecordingPaused 、ソフトミュートには AudioTrack.setEnabled を使う必要がありましたが、統一された API になりました
• 使い方は ミュート機能 をご確認ください

• Sora Android SDK 2025.3.0 ではハードミュートには org.webrtc.CameraVideoCapturer の startCapture() と stopCapture() 、ソフトミュートには VideoTrack.setEnabled を使う必要がありましたが、統一された API になりました
• 使い方は ミュート機能 をご確認ください

• SoraMediaChannel.rpc で JSON-RPC 2.0 over DataChannel による API 呼び出しができます
• 詳細は RPC 機能 をご確認ください

• enableSimulcast(null) としていた場合は、新旧どちらの enableSimulcast が利用されるかコンパイラが決定できないため以下の対応が必要です
  • 明示的に enableSimulcast(requestRid = null) のように名前付き引数を指定する
  • enableSimulcast() と引数を指定しないようにする
    • 移行先の enableSimulcast(requestRid: SoraVideoOption.SimulcastRequestRid? = null) が利用されますが、動作に変更はありません
• 以下の場合はコンパイラによって自動的に解決されるので移行作業は不要です
  • enableSimulcast(SoraVideoOption.SimulcastRid.R1) のように引数ありの場合は従来の SoraMediaOption.enableSimulcast(rid: SoraVideoOption.SimulcastRid?) に解決されます
  • enableSimulcast() のように引数なしの場合は移行先の enableSimulcast(requestRid: SoraVideoOption.SimulcastRequestRid? = null) に解決されます

• 移行先は SoraMediaChannel.setAudioHardMute です

• 2027 年 12 月リリースの Sora にて、シグナリング接続時の simulcast_rid が廃止予定であるため非推奨にしました
• 移行先は SoraMediaOption.enableSimulcast(requestRid: SoraVideoOption.SimulcastRequestRid? = null) です

• 同時に SoraMediaOption.enableSimulcast(rid: SoraVideoOption.SimulcastRid?) を非推奨化しました。今後は enableSimulcast(requestRid: SoraVideoOption.SimulcastRequestRid? = null) を利用してください

• SoraMediaChannel.setVideoHardMute などの VideoCapturer を操作する API を利用する場合は cameraConfig を設定する必要があります

• SimulcastRequestRid は NONE、R0、R1、R2 を指定できます

• Sora Android SDK の内部で CameraVideoCapturer を生成させる場合はこちらのメソッドを使います

• Android 端末のプライバシーインジケーターを消灯できる音声ミュートを実装できるようになりました
• 詳細は ミュート機能 をご確認ください

• 送受信中の音声を音声データとして取得できるようになりました
• 詳細は 音声データ取得機能 をご確認ください

• addSink
  • AudioTrack と AudioTrackSink を関連付けるためのメソッドです
• removeSink
  • AudioTrack と AudioTrackSink の関連付けを解除するためのメソッドです

• これにより、Sora から切断された際の理由を詳細に取得できるようになりました
• 詳細は Sora からの切断理由を取得できる onClose の追加 を参照してください

• 詳細は シグナリングの "type": "connect" メッセージの multistream を自動で true に設定する仕様を廃止 を参照してください

• 詳細は WebSocket が Sora から切断された際に受信したステータスコードが 1000 以外の場合でも onError を呼び出さないように変更 を参照してください

• 詳細は SoraMediaOption.videoCodec 未設定時の動作変更 を参照してください

• 詳細は SoraMediaOption.audioCodec 未設定時の動作変更 を参照してください

• 詳細は onError(SoraMediaChannel, SoraErrorReason) を廃止 を参照してください

• 詳細は 解像度維持方法の fixedResolution を廃止、 DegradationPreference を追加 を参照してください

• 今後は onClose(SoraMediaChannel, SoraCloseEvent) を利用してください
• 移行方法は Sora からの切断理由を取得できる onClose の追加 を参照してください

• これまでは CameraCapturerFactory.create の引数 fixedResolution に true を指定することにより送信する映像の解像度維持をすることができていましたが、この仕様を廃止しました。
• 代替の機能として、SoraMediaOption.degradationPreference を追加しました

• SoraMediaOption.enableSpotlight を設定すると、内部で multistream を true に設定していましたが、この仕様を廃止しました
• 以下の設定の組み合わに応じて自動で multistream を true に設定していましたが、この仕様を廃止しました
  • enableAudioDownstream
  • enableVideoDownstream
  • enableAudioUpstream
  • enableVideoUpstream

• これまでの実装では、onError のコールバック呼び出しが定義されていましたが、実際には onClosing が実行された時点で SignalingChannelImpl の listener の参照が削除されるため、onError が確実に呼び出される保証はありませんでした
• 今回の変更により、onClose においてステータスコードと切断理由を取得できるようになりエラーハンドリングが可能となったため、onError の呼び出しは不要となりました
• これにより、onError はネットワーク切断などによる異常終了のみを通知する仕様となります
• もし、ステータスコード 1000 以外の Sora からの切断を onError によって検知する実装を行っていた場合、今後は onClose のステータスコードを参照し、適切な処理を行う必要があります

• これまでは、SoraMediaOption.videoCodec が未設定の場合、connect メッセージの video.codec_type にデフォルトで VP9 が設定され、送信されていました
• 今回の変更により、未設定の場合は video.codec_type を送信しなくなりました
• 未設定の場合、Sora 側でデフォルトのビデオコーデックとして VP9 が設定されます
  • 参考: https://sora-doc.shiguredo.jp/SIGNALING#d47f4d
• SoraMediaOption.videoCodec が未設定であり、かつ SoraMediaOption.videoVp9Params を設定している場合は破壊的変更の影響を受けるため、明示的に SoraMediaOption.videoCodec に SoraVideoOption.Codec.VP9 を設定する必要があります

• これまでは SoraMediaOption.audioCodec が未設定の場合、connect メッセージの audio.codec_type にデフォルトで OPUS が設定され、送信されていました
• 今回の変更により、未設定の場合は audio.codec_type を送信しなくなりました
• 未設定の場合、Sora 側でデフォルトのオーディオコーデックとして OPUS が設定されます
  • 参考: https://sora-doc.shiguredo.jp/SIGNALING#0fcf4e
• SoraMediaOption.audioCodec が未設定であり、かつ SoraMediaOption.audioOption.opusParams を設定している場合は破壊的変更の影響を受けるため、明示的に SoraMediaOption.audioCodec に SoraAudioOption.Codec.OPUS を設定する必要があります

• onError(SoraMediaChannel, SoraErrorReason) を呼び出していた箇所は onError(SoraMediaChannel, SoraErrorReason, String) に置き換えられます
• String にはエラーの詳細情報が渡されます
  • 詳細がない場合は空文字列が渡されます

• Sora 2025.1.0 以降は connect メッセージの multistream 項目が廃止されました
• これに合わせ、SDK でも multistream を自動で true に設定する挙動を廃止しました（関連: シグナリングの "type": "connect" メッセージの multistream を自動で true に設定する仕様を廃止）
• 非推奨にした設定

  • SoraMediaOption.enableMultistream: これまで multistream: true を明示するための設定でしたが、Sora 2025.1.0 以降は非推奨です
  • SoraMediaOption.enableLegacyStream: これまで multistream: false （レガシーストリーム）を明示するための互換設定でしたが、レガシーストリーム自体が廃止されたため非推奨です

• Sora から切断された際に通知されるイベントである SoraCloseEvent を追加しました
• WebSocket シグナリング切断時に通知されるイベントである SignalingChannelCloseEvent を追加しました
• 以下の場合に、Sora から切断された際に SoraCloseEvent が通知されます:
  • SoraMediaChannel.disconnect() を呼び出した場合
  • WebSocket 経由のシグナリングを利用している場合
  • DataChannel 経由のシグナリングを利用する場合、かつ ignore_disconnect_websocket が true であり、かつ Sora の設定で data_channel_signaling_close_message が有効な場合

• 今後は onClose(SoraMediaChannel, SoraCloseEvent) を利用してください

• org.jetbrains.dokka:dokka-gradle-plugin を 1.9.20 にアップデートしました
• com.google.code.gson:gson を 2.13.1 にアップデートしました
• org.ajoberstar.grgit:grgit-gradle を 5.3.2 にアップデートしました
• org.jetbrains.kotlinx:kotlinx-coroutines-android を 1.9.0 にアップデートしました
• org.robolectric:robolectric を 4.15.1 にアップデートしました

• クライアント側の状況により設定した解像度やフレームレートを維持できなくなった場合にどのように質を下げるか制御できるオプションです
• オプション追加前よりデフォルトの挙動で動作していたため互換性に影響はありません

• scaleResolutionDownTo の詳細については Sora のドキュメントの サイマルキャスト機能 を参照してください

• DataChannel シグナリングが有効、かつ ignore_disconnect_websocket が true、かつ Sora の設定で data_channel_signaling_close_message が有効な場合に受信可能です
• 受信したメッセージは SoraCloseEvent として onClose(SoraMediaChannel, SoraCloseEvent?) に通知されます

• 映像配信時に端末のハードウェアエンコーダーを使わず、ソフトウェアエンコーダーのみで送信するためのオプションです
• デフォルトは false であるため互換性に影響はありません
• true の場合、サイマルキャスト有効時を含めソフトウェアエンコーダーのみでエンコードするようになります
• 映像の配信が有効な場合に適用されるため、視聴のみの場合は影響ありません
• videoEncoderFactory を設定している場合は本オプションは無視されます
• ソフトウェアエンコードは CPU 使用率・発熱・電力消費が増える可能性がありますので注意してください

• 従来は切断処理の完了前に onClose が呼び出されていましたが、 onClose は切断後に通知されるのが望ましいため、切断完了後に呼び出されるよう修正しました