割り当てと制限
SkyWay では、すべてのユーザーに公平かつ安定的にシステムをご利用いただくために、各アプリケーションが使用可能なリソース量に一定の割り当てを定め、リクエストの頻度に制限を設けております。 割り当てと制限は利用される SDK に関わらず、アプリケーション(アプリケーション ID)ごとに適用されます。
リソースの割り当て
リソースの割り当ては、同時に利用可能なリソース(Room(Channel) と Member、Publication、Subscription)の数を定めるものです。 ユーザーはこれらの割り当て量を超えて、リソースを作成することはできません。リソースの割当を以下の表に示します。
割り当ての種類 | 割当量 |
---|---|
Room(Channel)あたりの最大同時Member数 | 320 |
Room(Channel)あたりの最大同時Publication数 | 256 |
Room(Channel)あたりの最大同時Subscription数 | 5120 |
Memberあたりの最大同時Publication数 | 8 |
Memberあたりの最大同時Subscription数 | 128 |
Publicationあたりの最大同時Subscription数 | 320 |
なお、Room(Channel) あたりの最大同時 Member、Publication、Subscription 数の制限について、 SFU Bot によって作られたリソースの数は含まれません。
また、Member あたりの最大同時 Publication 数について、SFU Bot は最大で128個まで同時に Publish することが可能です。
リクエストレートの制限
リクエストレートの制限は、SkyWay のサーバーに対して実行可能なリクエストの数を定めるものです。リクエストレートの制限は、以下の表に示す二種類の制限があります。
制限 | 制限値 |
---|---|
1秒あたりの最大Channel作成リクエスト数 | 20 |
Channelごとの1秒あたりの最大リクエスト数 | 500 |
Channel ごとの1秒あたりの最大リクエスト数は、Member の入室や退室、Metadata の変更の他、Channel 内の Publication や Subscription などのリソースに対するすべてのリクエストが対象となります。
Channelの有効期限
Channel は作成した時点より7日間有効で、有効期限が延長されることはありません。 Channel の削除をせずに利用を続けて有効期限を迎えた場合、通話の途中で接続が切れる可能性があります。
これを防ぐために、同じ Channel を長期間使い続けるのではなく、ユーザが居なくなったタイミングで Channel を削除するといった実装をおすすめします。
Channel、Memberのnameとして使用可能な文字種
Room(Channel)、Memberにはそれぞれ任意のnameを設定することができますが、使用可能な文字種・文字数に制限があります。
制限の内容は以下のとおりです。
制限の種類 | 制限の内容 |
---|---|
使用可能な文字種 | a-z , A-Z , 0-9 , - , . , _ , % , * で構成された文字のみ |
文字数 | 1~128文字(0文字は許容されない) |
ただし、 *
単体を指定することはできません。
Channel、Memberのmetadataとして使用可能な文字種
Room(Channel)、Memberにはそれぞれ任意のmetadataを設定することができますが、使用可能な文字種・文字数に制限があります。
制限の内容は以下のとおりです。
制限の種類 | 制限の内容 |
---|---|
使用可能な文字種 | (アルファベット、数字、記号、日本語等を含む)任意の文字 |
文字数 | 0~1024文字 |
SkyWay Auth Tokenのサイズの制限
SkyWay Auth Tokenは、ヘッダー部、ペイロード部、署名部すべてを含めて、 7 KB 以下である必要があります。