2021.2.x から 2022.1.x への移行¶
概要¶
2021.2.x から 2022.1.x への移行について注意点をまとめています。
シグナリング通知メタデータ metadata_list の廃止¶
2022 年 6 月リリースの Sora にて metadata_list が data に変更されることに伴い、
sora.conf の unuse_metadata_list のデフォルトを true に変更しました。
詳細は シグナリング通知メタデータ metadata_list の廃止 をご確認ください。
リモート統計情報 API を廃止¶
sora.conf の remote_stats を廃止しました。
リモート統計情報 API は user_agent_stats が true であれば、
利用可能ですので、何か設定をしていただく必要はありません。
詳細は 廃止 リモート統計情報 API をご確認ください。
分割録画で通知されるウェブフックのタイプを変更しました¶
"type": "archive.split"から"type": "split-archive.availableに変更しました。"type": "archive.end"から"type": "split-archive.endに変更しました。
sora.conf の split_archive_legacy_prefix を true にすることで type: archive.split と "type": "archive.end" がそのまま利用できます。
split_archive_legacy_prefix は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。
分割録画で出力される録画ファイル名とメタデータファイル名を変更しました¶
archive-<connection-id>_<index>.webmをsplit-archive-<connection-id>_<index>.webmに変更しました。archive-<connection-id>_<index>.jsonをsplit-archive-<connection-id>_<index>.jsonに変更しました。
sora.conf の split_archive_legacy_prefix を true にすることで archive-<connection-id>_<index>.webm と archive-<connection-id>_<index>.json がそのまま利用できます。
split_archive_legacy_prefix は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。
クラスター設定名を一部変更しました¶
cluster_node_name を node_name に変更しました¶
クラスターのノード名を指定する sora.conf の cluster_node_name を node_name に変更しました。
cluster_api_url を external_api_url に変更しました¶
クラスター利用時に外から見える API URL を指定する sora.conf の cluster_api_url を external_api_url に変更しました。
cluster_signaling_url を external_signaling_url に変更しました¶
クラスター利用時に外から見えるシグナリング URL を指定する sora.conf の cluster_signaling_url を external_signaling_url に変更しました。
クラスター API 引数を一部変更しました¶
JoinCluster API¶
クラスターを参加させる JoinCluster API の cluster_node_name を contact_node_name に変更しました。戻り値も cluster_node_name_list から node_name_list に変更しました。
ListClusterNode API¶
クラスターノード一覧を確認する ListClusterNodes API の戻り値を変更しました。
cluster_node_nameをnode_nameに変更しましたcluster_api_urlをexternal_api_urlに変更しましたcluster_signaling_urlをexternal_signaling_urlに変更しましたsora_versionをversionに変更しました
クラスター参加への参加を自動化する機能を追加しました¶
sora.conf. の contact_node_name_list の利用することで、クラスターへの参加を JoinCluster API なしで自動で行います。
詳細は contact_node_name_list をご確認ください。
クラスターノードリストの永続化用のディレクトリ data/ 以下にファイルが作られるようになりました¶
クラスターノードリストを保存するために Sora が内部的に利用する data/cluster-nodes.bin というファイルが生成されるようになりました。
そのため data/ 以下に読み込み、書き込み、および実行の権限を与えるようにしてください。
このファイルは Sora ノードをアップデートする際にコピーする必要はありません。特に利用者が意識する必要はありません。