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