WebRTC SFU Sora¶
概要¶
- Sora バージョン:
2023.1.3
Sora Cloud で提供している Sora についてまとめています。
Sora 最新バージョンの適用¶
正式版¶
Sora Cloud の Sora はパッケージ版の Sora が正式リリースされた 3 ヶ月以内に最新版が利用可能になります。
注釈
Sora パッケージ版の正式リリースは 6 月と 12 月に行います。
正式版のリリース時にはサービス停止を伴うメンテナンスを行う場合があります。 その場合は 1 ヶ月以上前にメンテナンス計画を共有します。
メンテナンス時間は長くても 3 時間で 21:00~24:00 の間に行います。
修正版¶
Sora Cloud の Sora の修正版のデプロイはサイレントに行います。
サービス停止を伴うメンテナンスは基本的に行いません。
Sora の互換性¶
シグナリングやウェブフックの破壊的変更可能な限り行いません。
もし破壊的変更を行う場合は 1 年以上の移行期間をもうけます。
Sora の実験的機能¶
Sora Cloud では Sora の実験的機能を利用する際、ご連絡頂く必要はありません。
クラスター数¶
Sora のクラスターは少なくとも 3 ノード以上のクラスターで構築されています。
Sora API URL¶
- URL:
https://api.sora-cloud.shiguredo.app/sora-api
x-sora-target
ヘッダー利用する Sora API を指定してください
シグナリング URL¶
シグナリング URLは以下を全て指定してください。
wss://0001.sora.sora-cloud.shiguredo.app/signaling
wss://0002.sora.sora-cloud.shiguredo.app/signaling
wss://0003.sora.sora-cloud.shiguredo.app/signaling
非推奨¶
重要
現在シグナリング URL の一本化に利用している Cloudflare LB が突然 WebSocket を切断する状況が発生しています。
そのため、こちらのシグナリング URL を利用場合は ignore_disconnect_websocket
を true
の時のみとしてください。
wss://sora.sora-cloud.shiguredo.app/signaling
TURN URLs¶
これらの値を意識する必要はありません
turn://<シーケンス番号>.sora-turn.sora-cloud.shiguredo.app
turns://<シーケンス番号>.sora-turn.sora-cloud.shiguredo.app
WHIP エンドポイント URL¶
Bearer Token にはアクセストークンを指定してください。
https://sora.sora-cloud.shiguredo.app/whip/<channel-id>
WHIP リソース URL¶
これらの値を意識する必要はありません
現時点では DELETE メソッドのみに対応しています。
https://sora.sora-cloud.shiguredo.app/whip-resource/<channel_id>/<secret>
ヘルスチェック URL¶
Sora Cloud で提供している Sora は接続するクライアントが 0 のタイミングでサイレントでメンテナンスを行うため、 Sora のヘルスチェック機能の利用は推奨していません。
それでも Sora のヘルスチェックが必要な場合はチケットを作成してください。
sora.conf¶
Sora 2023.1.x¶
項目名 |
値 |
備考 |
---|---|---|
devtools |
false |
https://sora-devtools.shiguredo.jp/ をお使いください |
ipv6 |
true |
|
default_data_channel_signaling |
true |
|
data_channel_messaging_only |
true |
|
data_channel_messaging |
true |
|
legacy_log_format |
false |
|
legacy_log_extension |
false |
|
ignore_connection_failed_webhook |
false |
|
legacy_webhook_audio_video_json_structure |
false |
ウェブフックの audio/video 項目がフラット化されます |
multistream_auto_sharing_video_bit_rate |
false |
そのままの帯域が利用されますのでご注意ください |
e2ee |
true |
|
av1 |
true |
|
h265 |
true |
|
lyra |
true |
|
lyra_param_bitrate |
6000 |
|
signaling_vp9_params |
true |
|
signaling_av1_params |
true |
|
signaling_h264_params |
true |
|
whip |
true |
|
whip_bearer_token_metadata_key |
access_token |
|
signaling_forwarding_filter |
true |
|
signaling_bundle_id |
true |