2021.2.x から 2022.1.x への移行

概要

2021.2.x から 2022.1.x への移行について注意点をまとめています。

シグナリング通知メタデータ metadata_list の廃止

2022 年 6 月リリースの Sora にて metadata_listdata に変更されることに伴い、 sora.confunuse_metadata_list のデフォルトを true に変更しました。

詳細は シグナリング通知メタデータ metadata_list の廃止 をご確認ください。

リモート統計情報 API を廃止

sora.confremote_stats を廃止しました。

リモート統計情報 API は user_agent_statstrue であれば、 利用可能ですので、何か設定をしていただく必要はありません。

詳細は 廃止 リモート統計情報 API をご確認ください。

分割録画で通知されるウェブフックのタイプを変更しました

  • "type": "archive.split" から "type": "split-archive.available に変更しました。

  • "type": "archive.end" から "type": "split-archive.end に変更しました。

sora.confsplit_archive_legacy_prefixtrue にすることで type: archive.split"type": "archive.end" がそのまま利用できます。

split_archive_legacy_prefix は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。

分割録画で出力される録画ファイル名とメタデータファイル名を変更しました

  • archive-<connection-id>_<index>.webmsplit-archive-<connection-id>_<index>.webm に変更しました。

  • archive-<connection-id>_<index>.jsonsplit-archive-<connection-id>_<index>.json に変更しました。

sora.confsplit_archive_legacy_prefixtrue にすることで archive-<connection-id>_<index>.webmarchive-<connection-id>_<index>.json がそのまま利用できます。

split_archive_legacy_prefix は 2023 年 6 月リリースの Sora にて廃止されますので、それまでの移行をお願いします。

クラスター設定名を一部変更しました

cluster_node_name を node_name に変更しました

クラスターのノード名を指定する sora.confcluster_node_namenode_name に変更しました。

cluster_api_url を external_api_url に変更しました

クラスター利用時に外から見える API URL を指定する sora.confcluster_api_urlexternal_api_url に変更しました。

cluster_signaling_url を external_signaling_url に変更しました

クラスター利用時に外から見えるシグナリング URL を指定する sora.confcluster_signaling_urlexternal_signaling_url に変更しました。

クラスター API 引数を一部変更しました

JoinCluster API

クラスターを参加させる JoinCluster API の cluster_node_namecontact_node_name に変更しました。戻り値も cluster_node_name_list から node_name_list に変更しました。

ListClusterNode API

クラスターノード一覧を確認する ListClusterNodes API の戻り値を変更しました。

  • cluster_node_namenode_name に変更しました

  • cluster_api_urlexternal_api_url に変更しました

  • cluster_signaling_urlexternal_signaling_url に変更しました

  • sora_versionversion に変更しました

クラスター参加への参加を自動化する機能を追加しました

sora.conf.contact_node_name_list の利用することで、クラスターへの参加を JoinCluster API なしで自動で行います。

詳細は contact_node_name_list をご確認ください。

クラスターノードリストの永続化用のディレクトリ data/ 以下にファイルが作られるようになりました

クラスターノードリストを保存するために Sora が内部的に利用する data/cluster-nodes.bin というファイルが生成されるようになりました。 そのため data/ 以下に読み込み、書き込み、および実行の権限を与えるようにしてください。

このファイルは Sora ノードをアップデートする際にコピーする必要はありません。特に利用者が意識する必要はありません。

© Copyright 2022, Shiguredo Inc Created using Sphinx 5.2.1