ミーティング API 技術詳細
Starting on August 31st 2024, users will no longer be able to create Meetings API applications. Existing applications will continue to work uninterrupted until June 30th, 2025. To build with video, use the Vonage Video API or start with the Vonage Video API Reference App. Contact your account manager or support for migration guidance.
内容
- Meetings APIかVideo APIか?:どのAPIがあなたのプロジェクトにより適しているかを判断する。
- 用語解説:Meetings APIの主な用語と定義。
- 部屋タイプ:利用可能な部屋のタイプを定義します。
- ウェブサイトとアプリの埋め込み:iFrameを使用して、Webサイトやアプリケーションにミーティングを埋め込むことができます。
- 参考:Meetings APIについての詳細情報。
- 価格:Meetings APIを利用するための費用に関する情報。
Meetings APIかVideo APIか?
Meetings API と Video API の両方を使用すると、Web アプリケーションで高品質のインタラクティブなビデオ会議を使用できます。Meetings API は、カスタマイズを制限したプラグアンドプレイのミーティングが必要な場合に最適です。ミーティングを生成してアプリケーションに埋め込むのに必要なコードはわずか数行です。Video API は、より多くのカスタマイズと柔軟性をお求めの方に最適ですが、開発の手間がかかります。
を見てみよう。 Video API のドキュメントを参照してください。
用語解説
- 部屋ビデオ会議が行われる仮想空間。参照 部屋タイプ の下にある。
- 参加者:
- オーナー通常、部屋の作成者であり、特別な管理能力を持つ。
- ゲスト会議参加者標準的なミーティング機能をご利用いただけます。
- 各部屋は最大250名の参加者を収容でき、25のアクティブ・ビデオ・ストリームを使用できます。
- 設定と構成:
- リクエスト部屋をセットアップするために送信するコードスニペット。
- 応答: リクエストから返されるデータ。
- 会議室IDの
IDは、ミーティングリクエストに対する応答で返されるセッション識別子である。 - セッション最初の参加者が加わってから最後の参加者が去るまで、その間に起こるすべての出来事と定義される。
- ゲストURLミーティングルーム URL
- ホストURL: ホストが使用する会議管理機能を持つ会議室の URL。
- テーマアカウント内の指定された部屋に適用する色、ロゴ、スタイルのセット。
- 特徴:
- ホワイトラベル特定のブランドや配色で部屋を作ることができる。
- チャット: 出席者全員に見えるようにメッセージを書くスペース。
- レコーディング会議中に手動で録音を開始することも、リクエスト送信時に自動的に録音するように設定することもできます。また、部屋のオーナーだけを録画することもできます。
- 客室管理部屋に関する情報を削除、更新、取得することができます。
- コールバックセッションに関する情報を受け取ることができます。
- 控室: 会議に参加するために必要な承認レベルを設定します。参加者は、必要な承認レベルに応じて、オーナーが参加するか、オーナーが認めるまで控室に参加します。
部屋タイプ
部屋タイプは2つある:
- インスタント・ルーム:
- 今行われている会議のために作られた。
- 最初の参加者が入室するまで10分間有効です。 10分以内に誰も入室しなかった場合、その部屋は削除されます。
- 最後の参加者が退席してから10分間有効で、その後削除される。
- ロング・ターム・ルーム:
- 指定した有効期限(最長1年)まで生き続ける。
- 通常、定期的に開催される会議、人物、リソースにリンクしている。
- 有効期限を指定する必要があります(ISO形式)。
- 最後の参加者が退室してから10分後に、その部屋を自動的に削除するように要求することができます.
注意:1つのアプリケーションにつき1000室まで作成できます。それ以上必要な場合は Meetings APIチームへのお問い合わせ.
ウェブサイトとアプリの埋め込み
APIを通じて作成されたミーティングは、ウェブサイトやモバイルアプリケーションに埋め込むことができます。これを行うには、会議リンクを生成して GUEST_URL:
<iframe src="$GUEST_URL" title="Embedded Meeting" allow="camera;microphone;display-capture"></iframe>
現在、以下のブラウザを使用して、デスクトップとモバイルの両方でサポートされています:
- デスクトップ - FirefoxおよびChromeベースのブラウザでサポートされています。
- iOS 14+ - Safari、Edge、Firefoxでサポートされています。
- Android - ChromeまたはSamsungブラウザv14+でサポートされています。
会議は360PX以上のどのサイズでも表示できますが、利用できる機能の数はiFrameのサイズによって異なります:
| 特徴 | 360-500PX | 500-600PX | 600PX+ |
|---|---|---|---|
| マイク | |||
| ビデオ | |||
| 記録 | |||
| シェア画面 | |||
| 反応 | |||
| プライバシー | |||
| ホワイトボード | |||
| 一緒に見る | |||
| ラウンドテーブル | |||
| ミーティング終了 |
360-500PXミーティングでも、録音は可能です。 auto_record パラメーターをAPIコールで使用する。
また、以下のメールアドレスにリクエストを送信する必要があります。 ミーティング APIチーム を使用して、iFrame が使用されているウェブサイトのドメインをホワイトラベル化します。
価格
料金は参加者と録音分数の両方に基づいています。
参加者議事録
参加者分数は、セッションの参加者1人あたり1分ごとに課金されます。1分あたりの料金は、参加者分数を月に何分使用するかによって決まります:
| より | へ | 1分あたりのレート |
|---|---|---|
| 0 | 100,000 | €0.00475 |
| 100,000 | 1,000,000 | €0.00428 |
| 1,000,000 | 5,000,000 | €0.00385 |
| 5,000,000 | 15,000,000 | €0.00327 |
| 15,000,000 | 前進 | €0.00262 |
例えば、100,000参加者分まで使用した場合、4人の参加者と1時間通話するのに1.14ユーロかかり、1分あたり0.00475ユーロで課金されます。
議事録作成
録音分数は、セッションが録音される1分ごとに課金されます。1分あたりの料金は、月に何分録音分を使用するかによって決まります:
| より | へ | 1分あたりのレート |
|---|---|---|
| 0 | 50,000 | €0.035 |
| 50,001 | 250,000 | €0.029 |
| 250,001 | 500,000 | €0.027 |
| 500,001 | 1,000,000 | €0.023 |
| 1,000,001 | 2,000,000 | €0.0185 |
| 2,000,001 | 前進 | €0.016 |
例えば、50,000分まで利用した場合、1時間の通話を録音するのに2.10ユーロかかり、1分あたり0.035ユーロで課金される。
Meetings APIを通した通話の合計コスト = 参加者分数 + 録音分数。上記の例では、合計コストは次のようになります。 €1.14 + €2.10 = €3.24