Skip to content

非公式本サイトは非公式の日本語ドキュメントであり、Cloudflare 公式サイトではありません。最新情報はdevelopers.cloudflare.comをご確認ください。

Preset

最終更新 Markdown で表示Agent セットアップ

Preset（プリセット）は、Meeting での参加者体験を定義する再利用可能な設定です。次の内容を決めます。

  • 参加するミーティングの種類（Video、Audio、Webinar、または Livestream Beta）
  • 実行できる操作（権限とコントロール）
  • UI の見た目（色やテーマを含む）。アプリケーションのブランディングに合わせられます。

Preset は App に属し、Meeting ではなく参加者に適用します。

Add Participant API で参加者を作成するとき、同じ Preset を複数の参加者に割り当てられます。同じ Meeting 内の参加者に異なる Preset を設定できるので、ユーザーごとに役割と体験を分けられます。

例: 大規模な Ed-Tech 教室

  • 教師 は webinar-host Preset を使います。メディアの共有とホストコントロールを利用できます。
  • 生徒 は webinar-participant Preset を使います。メディアは共有できませんが、チャットなどの機能は使えます。
  • ティーチングアシスタント は group-call-host Preset を使います。メディアは共有できますが、ホストの全権限はありません。

Preset を作成する

Cloudflare dashboard ↗ でアプリを作成すると、デフォルトの Preset が自動で作成されます。

dashboard ↗ または Create Preset API でも Preset を作成できます。

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/realtime/kit/$APP_ID/presets \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN" \
    -d '{
          "config": {
            ...<preset-configuration-json>
        }'

Preset Editor

Cloudflare dashboard ↗ で、UI ベースのエディターを使って Preset を作成・管理できます。

Preset エディター

権限は次のカテゴリに分かれます。

  • Host Controls: ミーティングの制御、参加者の管理、ユーザーの退出、他者の映像・音声のミュートなど、管理操作を許可します。

  • Stage Management: 大規模ミーティングでは仮想ステージを設定できます。ステージ上の参加者は音声と映像を共有できます。ステージ外の参加者はこのメディアを視聴でき、チャット、投票、プラグインも使えます。

    ユーザーはステージ参加をリクエストできます。ホストはいつでもユーザーをステージに追加・削除できます。 ステージ管理の詳細は Meetings を参照してください。

  • Chat: RealtimeKit では、ユーザーがリアルタイムでメッセージを送受信できます。特定のユーザーにだけ見えるプライベートメッセージも送れます。各種メッセージの送信と受信を誰に許可するかを設定できます。

  • Polls: ミーティング内の投票の作成、閲覧、操作を誰ができるかを設定できます。

  • Plugins: プラグインは、ミーティング内で動くインタラクティブなリアルタイムアプリケーションです。共同作業を簡単にします。RealtimeKit では独自プラグインを作成でき、Whiteboard や Document Sharing などの組み込みオプションもあります。

    参加者が閲覧、開く、閉じることを許可するプラグインを制御できます。

  • Waiting Room: 待機室では、参加者が入場を許可される前にミーティングへ参加できます。ホストが入室者とタイミングを制御できます。アクセス管理、割り込みの削減、スムーズな開始に役立ちます。

    ホストはいつでも参加者を入場させたり除外したりできます。待機室を自動でスキップする対象も設定できます。 待機室の詳細は Meetings を参照してください。

  • Connected Meetings: Connected Meetings では、メインのミーティングをリンクした空間に分割し、少人数の議論や並行セッションを行えます。権限により、参加者が Connected Meetings 間を移動できるか、親ミーティングに戻れるか、それらのミーティングを作成・更新・削除できるかが決まります。

    詳細は Meetings の Connected Meetings を参照してください。

  • Miscellaneous: 特定カテゴリに当てはまらない、参加者体験の追加項目を細かく調整できます。

    名前の編集、参加者リストの表示、タブ表示の同期、文字起こしの有効化など、ミーティング内での操作を補う機能を制御します。

次のステップ

Meetings と Sessions を理解したあと、次のステップに進めます。

  • Meeting に Participants を追加する — 参加できる人、役割、継承するアクセス制御を管理します。
  • RealtimeKit SDKs を始める — 数行のコードで、Web またはモバイルアプリに RealtimeKit を組み込めます。

役に立ちましたか？