イベントウェブフック¶

ウェブフックリクエスト送信先のサーバーがベーシック認証を利用している場合¶

もしウェブフックリクエスト送信先のサーバーがベーシック認証を利用している場合は sora.conf にて webhook_basic_authn に true を設定することでベーシック認証を利用できます。

webhook_basic_authn_user_id と webhook_basic_authn_password に使用するユーザー ID とパスワードを設定して下さい。

ウェブフックリクエスト送信先のサーバーが自己署名証明書などを利用している場合¶

この設定はおすすめしません

デフォルトでは自己署名証明書などの正規の認証局から発行されていない証明書を利用した場合には、信頼できないと判断しエラーになります。

もし自己署名証明書を利用したサーバーがウェブフックリクエスト送信先になる場合は、 sora.conf にて webhook_insecure に true を設定することで証明書のチェックを行わないようになります。

event_webhook_url¶

デフォルト:

未設定

イベントウェブフックリクエスト送信先の URL です。イベントウェブフック機能を利用する場合は指定してください。

この URL には HTTPS の URL を指定することもできます。

HTTPS の URL を指定する場合、リクエスト送信先のアプリケーションについて基本的には正規の認証局から発行された証明書を利用してください。

独自の証明書を利用する場合は ウェブフックリクエスト送信先のサーバーが自己署名証明書などを利用している場合 をご確認ください。

HTTP のレスポンスは 200 OK 等の 200 番台のステータスコードの必要があります。

共通項目¶

• id
  • イベントごとの ID です
• version
  • Sora のバージョンが 文字列 で入ってきます
• label
  • sora.conf の label で指定した値が入ってきます
• node_name
  • Sora のノード名が入ってきます
• log_written
  • イベントウェブフックログの書き込みが成功したかどうかが入ってきます
  • 書き込みが成功した場合は true が入ってきます
• minutes
  • 接続経過時間 (分) が入ってきます
• created_time
  • connection.created 時の時間が UNIX 時間形式で入ってきます
• created_timestamp
  • connection.created 時の時間が RFC 3339 UTC 形式 (マイクロ秒) で入ってきます
• total_received_bytes
  • Sora がクライアントから受信したパケットの合計数です
• total_sent_bytes
  • Sora がクライアントへ送信したパケットの合計数です
• turn_transport_type
  • udp か tcp が入ってきます
  • TURN-UDP または TURN-TCP (TURN-TLS 含む) のどちらを使用したかがわかります
• audio
  • true または false が入ってきます
  • false の場合は audio を使用しません
  • sora.conf の legacy_webhook_audio_video_json_structure を true にした場合はレガシーな構造で送られてきます
    • 詳細は ウェブフックの audio と video 項目の JSON 構造のフラット化 をご確認ください
• audio_codec_type
  • この項目はオプションです
  • audio が false の場合は含まれません
  • コーデックの種類は OPUS または LYRA です
• audio_bit_rate
  • この項目はオプションです
  • audio が false やクライアントが送ってこない場合、含まれません
  • この設定は audio_codec_type が OPUS の時のみ有効です
  • default_audio_bit_rate に値を指定していた場合はその値が利用されます
  • 最小が 6 で、最大が 510 です
  • 単位は kbps です
• video
  • true または false が入ってきます
  • false の場合は video を使用しません
  • sora.conf の legacy_webhook_audio_video_json_structure を true にした場合はレガシーな構造で送られてきます
    • 詳細は ウェブフックの audio と video 項目の JSON 構造のフラット化 をご確認ください
• video_codec_type
  • この項目はオプションです
  • video が false の場合は含まれません
  • コーデックはクライアントが送ってこない場合はデフォルトで VP9 が使用されます
  • コーデックの種類は VP8、 VP9、 AV1、 H264、 H265 です
• video_bit_rate
  • この項目はオプションです
  • video が false の場合は含まれません
  • ビットレートはクライアントが送ってこない場合は sora.conf の default_video_bit_rate が使用されます
  • デフォルトは 500 です
  • 最小が 1 で、最大が 30000 です
  • 15000 より大きい値は現時点でサポート範囲外です
  • 単位は kbps です
• video_vp9_profile_id
  • この項目はオプションです
  • video が false の場合は含まれません
  • 詳細は ビデオの VP9 設定指定 をご確認ください
• video_av1_profile
  • この項目はオプションです
  • video が false の場合は含まれません
  • 詳細は ビデオの AV1 設定指定 をご確認ください
• video_h264_profile_level_id
  • この項目はオプションです
  • video が false の場合は含まれません
  • 詳細は ビデオの H.264 設定指定 をご確認ください
• multistream
  • true の場合はマルチストリームが有効な接続です
• simulcast
  • true の場合はサイマルキャストが有効な接続です
• spotlight
  • true の場合はスポットライトが有効な接続です
• role
  • sendrecv (送受信) / sendonly (送信のみ) / recvonly (受信のみ)
• event_metadata
  • この項目はオプションです
  • サーバーが定義を自由にできる値です
  • 認証サーバーから event_metadata を返した値が含まれます
  • 詳細は event_metadata の払い出し をご確認ください
• channel_id
  • コネクションが接続しているチャネル ID です
• session_id
  • コネクションが接続しているチャネル の現在のセッションの ID です
  • UUIDv4 を Base32 でエンコードした 26 バイトの文字列です
• client_id
  • コネクションに割り当てられたクライアント ID です
• bundle_id
  • コネクションに割り当てられたバンドル ID です
• connection_id
  • コネクションに割り当てられたユニークな ID です
  • UUIDv4 を Base32 でエンコードした 26 バイトの文字列です

connection.created¶

接続

シグナリングの接続が成功して、WebRTC としての通信が開始できるようになった時の状態を送信します。

• data.channel_connections
  • 現在そのチャネルに接続しているクライアントの接続数です
  • 自分は含まれます
• data.channel_sendrecv_connections
  • 現在そのチャネルで送受信している配信者の接続数です
  • 自分は含まれます
• data.channel_sendonly_connections
  • 現在そのチャネルを送信のみしている配信者の接続数です
  • 自分は含まれます
• data.channel_recvonly_connections
  • 現在そのチャネルを受信のみしている視聴者の接続数です
  • 自分は含まれます

{
  "type": "connection.created",
  "channel_id": "<String>",
  "session_id": "<Base32-UUIDv4>",
  "client_id": "<String | Base32-UUIDv4>",
  "bundle_id": "<String | Base32-UUIDv4>",
  "connection_id": "<Base32-UUIDv4>",
  "timestamp": "<UTC RFC3339 Timestamp>",
  "event_metadata": "<JSON Object>",
  "data": {
    "created_time": "<UNIX-Time>",
    "created_timestamp": "<UTC RFC3339 Timestamp>",
    "audio": "<Boolean>",
    "audio_codec_type": "<String>",
    "channel_connections": "<Integer>",
    "channel_recvonly_connections": "<Integer>",
    "channel_sendonly_connections": "<Integer>",
    "channel_sendrecv_connections": "<Integer>",
    "minutes": "<Integer>",
    "total_received_bytes": "<Integer>",
    "total_sent_bytes": "<Integer>",
    "turn_transport_type": "<String>",
    "video": "<Boolean>",
    "video_bit_rate": "<Integer>",
    "video_codec_type": "<String>"
  },
  "id": "<Base32-UUIDv4>",
  "label": "<String>",
  "node_name": "<String>",
  "log_written": "<Boolean>",
  "role": "<sendrecv | sendonly | recvonly>",
  "multistream": "<Boolean>",
  "simulcast": "<Boolean>",
  "spotlight": "<Boolean>",
  "version": "<String>"
}

connection.destroyed¶

切断

シグナリングの接続が切断した時に送信します。

• data.type_disconnect_reason
  • "type": "disconnect" 送信時に "reason" に指定した 文字列 が入ります
  • "reason" を指定していなかった場合、この項目は含まれません
• data.disconnect_api_reason
  • DisconnectChannel API または Disconnect API を利用して切断した際、オプションの "reason" に指定した JSON オブジェクト がこの "reason" に含まれます
  • "reason" を指定していなかった場合、この項目は含まれません
• data.reason
  • 基本的には data.disconnect_api_reason と同様です
  • ただし "reason" を指定していなかった場合に、項目が省略されるのではなく、値に null が入る点が異なっています
• data.channel_connections
  • 現在そのチャネルに接続しているクライアントの接続数です
  • 自分は含まれません
• data.channel_sendrecv_connections
  • 現在そのチャネルで送受信している配信者の接続数です
  • 自分は含まれません
• data.channel_sendonly_connections
  • 現在そのチャネルを送信のみしている配信者の接続数です
  • 自分は含まれません
• data.channel_recvonly_connections
  • 現在そのチャネルを受信のみしている視聴者の接続数です
  • 自分は含まれません
• data.destroyed_time
  • connection.destroyed 時の時間が UNIX 時間形式で入ってきます
• data.destroyed_timestamp
  • connection.destroyed 時の時間が RFC 3339 UTC 形式 (マイクロ秒) で入ってきます

{
  "type": "connection.destroyed",
  "channel_id": "<String>",
  "session_id": "<Base32-UUIDv4>",
  "client_id": "<String | Base32-UUIDv4>",
  "bundle_id": "<String | Base32-UUIDv4>",
  "connection_id": "<Base32-UUIDv4>",
  "timestamp": "<UTC RFC3339 Timestamp>",
  "event_metadata": "<JSON Object>",
  "data": {
    "created_time": "<UNIX-Time>",
    "created_timestamp": "<UTC RFC3339 Timestamp>",
    "destroyed_time": "<UNIX-Time>",
    "destroyed_timestamp": "<UTC RFC3339 Timestamp>",
    "audio": "<Boolean>",
    "audio_codec_type": "<String>",
    "channel_connections": "<Integer>",
    "channel_recvonly_connections": "<Integer>",
    "channel_sendonly_connections": "<Integer>",
    "channel_sendrecv_connections": "<Integer>",
    "minutes": "<Integer>",
    "reason": "<String>",
    "type_disconnect_reason": "<String>",
    "total_received_bytes": "<Integer>",
    "total_sent_bytes": "<Intger>",
    "turn_transport_type": "<String>",
    "video": "<Boolean>",
    "video_bit_rate": "<Integer>",
    "video_codec_type": "<String>"
  },
  "id": "<Base32-UUIDv4>",
  "label": "<String>",
  "node_name": "<String>",
  "log_written": "<Boolean>",
  "role": "<sendrecv | sendonly | recvonly>",
  "multistream": "<Boolean>",
  "simulcast": "<Boolean>",
  "spotlight": "<Boolean>",
  "version": "<String>"
}

connection.updated¶

接続状態更新

接続したタイミングから、クライアントごとの接続状態が、それぞれ 1 分間に 1 回送られてきます。

• data.channel_connections
  • 現在そのチャネルに接続しているクライアントの接続数です
  • 自分が含まれます
• data.channel_sendrecv_connections
  • 現在そのチャネルで送受信している配信者の接続数です
  • 自分が含まれます
• data.channel_sendonly_connections
  • 現在そのチャネルを送信のみしている配信者の接続数です
  • 自分が含まれます
• data.channel_recvonly_connections
  • 現在そのチャネルを受信のみしている視聴者の接続数です
  • 自分が含まれます

{
  "type": "connection.updated",
  "channel_id": "<String>",
  "session_id": "<Base32-UUIDv4>",
  "client_id": "<String | Base32-UUIDv4>",
  "bundle_id": "<String | Base32-UUIDv4>",
  "connection_id": "<Base32-UUIDv4>",
  "timestamp": "<UTC RFC3339 Timestamp>",
  "event_metadata": "<JSON>",
  "data": {
    "audio": "<Boolean>",
    "audio_codec_type": "<String>",
    "channel_connections": ,
    "channel_recvonly_connections": "<Integer>",
    "channel_sendonly_connections": "<Integer>",
    "channel_sendrecv_connections": "<Integer>",
    "created_time": "<UNIX-Time>",
    "created_timestamp": "<UTC RFC3339 Timestamp>",
    "minutes": "<Integer>",
    "total_received_bytes": "<Integer>",
    "total_sent_bytes": "<Integer>",
    "turn_transport_type": "<String>",
    "video": "<Boolean>",
    "video_bit_rate": "<Integer>",
    "video_codec_type": "<String>"
  },
  "id": "<Base32-UUIDv4>",
  "label": "<String>",
  "node_name": "<String>",
  "log_written": "<Boolean>",
  "role": "<sendrecv | sendonly | recvonly>",
  "multistream": "<Boolean>",
  "simulcast": "<Boolean>",
  "spotlight": "<Boolean>",
  "version": "<String>"
}

connection.failed¶

接続失敗

シグナリング接続 成功前 に失敗や異常が起きたりした場合に送信されます。

シグナリング接続成功後に失敗や異常が起きた場合は、 connection.destroyed が送信されます。

{
    "type": "connection.failed",
    "id": "<Base32-UUIDv4>",
    "role": "<sendrecv | sendonly | recvonly>",
    "channel_id": "<String>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "data": {
        "message": "<String>",
        "channel_connections": "<Integer>",
        "channel_sendrecv_connections": "<Integer>",
        "channel_sendonly_connections": "<Integer>",
        "channel_recvonly_connections": "<Integer>",
        "total_received_bytes": "<Integer>",
        "total_sent_bytes": "<Integer>"
    },
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "multistream": "<Boolean>",
    "simulcast": "<Boolean>",
    "spotlight": "<Boolean>",
    "version": "<String>"
}

recording.started¶

録画開始

• data.start_timestamp
  • StartRecording API を実行したタイムスタンプが入ります
• data.expire_time
  • StartRecording API で指定した expire_time が入ります
• data.expired_at
  • StartRecording API で指定した expire_time から計算した有効期限が入ります
• data.split_duration
  • この項目はオプションです
  • StartRecording API で指定した split_duration が入ります
  • 指定していない場合は split_duration の項目が入ってきません
• data.split_only
  • この項目はオプションです
  • StartRecording API で指定した split_only が入ります
  • 指定していない場合は false が入ります
• data.metadata
  • この項目はオプションです
  • StartRecording API で指定した metadata が入ります
  • 指定していない場合は metadata の項目が入ってきません

{
    "type": "recording.started",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "metadata": "<JSON-Object>",
        "split_only": "<Boolean>",
        "created_at": "<UNIX-Time>",
        "expire_time": "<Integer>",
        "expired_at": "<UNIX-Time>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "split_duration": "<Integer>"
    }
}

recording.report¶

録画結果報告

• data.archives[].start_time_offset
  • StartRecording API を叩いてから何秒経過した後にこの録画が開始したかを表しています
• data.archives[].stop_time_offset
  • StartRecording API を叩いてから何秒経過した後にこの録画が終了したかを表しています
• data.metadata
  • StartRecording API で指定した metadata が入ります
  • 指定していない場合は metadata の項目が入ってきません
• data.expired_at
  • 期限が切れた日時を UNIX Time で返します

{
    "type": "recording.report",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "metadata": "<JSON-Object>",
        "split_only": "<Boolean>",
        "created_at": "<UNIX-Time>",
        "expire_time": "<Integer>",
        "expired_at": "<UNIX-Time>",
        "file_path": "<String>",
        "filename": "<String>",
        "file_written": "<Boolean>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
        "archives": [
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>",
                "file_path": "<String>",
                "filename": "<String>",
                "metadata_file_path": "<String>",
                "metadata_filename": "<String>",
                "start_time_offset": "<Integer>",
                "start_timestamp": "<UTC RFC3339 Timestamp>",
                "stop_time_offset": "<Integer>",
                "stop_timestamp": "<UTC RFC3339 Timestamp>",
                "size": "<Integer>"
            },
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>",
                "file_path": "<String>",
                "filename": "<String>",
                "metadata_file_path": "<String>",
                "metadata_filename": "<String>",
                "start_time_offset": "<Integer>",
                "start_timestamp": "<UTC RFC3339 Timestamp>",
                "stop_time_offset": "<Integer>",
                "stop_timestamp": "<UTC RFC3339 Timestamp>",
                "size": "<Integer>"
            }
        ],
        "failed_archives": [
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>"
            },
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>"
            }
        ]
    }
}

{
    "type": "recording.report",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "metadata": "<JSON-Object>",
        "split_only": "<Boolean>",
        "split_duration": "<Integer>",
        "created_at": "<UNIX-Time>",
        "expire_time": "<Integer>",
        "expired_at": "<UNIX-Time>",
        "file_path": "<String>",
        "filename": "<String>",
        "file_written": "<Boolean>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
        "archives": [
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>",
                "start_time_offset": "<Integer>",
                "start_timestamp": "<UTC RFC3339 Timestamp>",
                "stop_time_offset": "<Integer>",
                "stop_timestamp": "<UTC RFC3339 Timestamp>",
                "split_last_index": "<String>"
            },
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>",
                "start_time_offset": "<Integer>",
                "start_timestamp": "<UTC RFC3339 Timestamp>",
                "stop_time_offset": "<Integer>",
                "stop_timestamp": "<UTC RFC3339 Timestamp>",
                "split_last_index": "<String>"
            }
        ],
        "failed_archives": [
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>"
            },
            {
                "label": "<String>",
                "node_name": "<String>",
                "client_id": "<String | Base32-UUIDv4>",
                "bundle_id": "<String | Base32-UUIDv4>",
                "connection_id": "<Base32-UUIDv4>"
            }
        ]
    }
}

archive.started¶

録画ファイル保存開始

• data.start_timestamp
  • この録画が開始された時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています

{
    "type": "archive.started",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "session_id": "<Base32-UUIDv4>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "event_metadata": "<JSON>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "session_id": "<Base32-UUIDv4>",
        "client_id": "<String | Base32-UUIDv4>",
        "bundle_id": "<String | Base32-UUIDv4>",
        "connection_id": "<Base32-UUIDv4>",
        "created_at": "<Unix Time>",
        "audio": true,
        "audio_codec_type": "<String>",
        "video": true,
        "video_codec_type": "<String>",
        "video_bit_rate": "<Integer>",
        "start_time": "<Unix Time>",
        "start_time_offset": "<Integer>",
        "start_timestamp": "<UTC RFC3339 Timestamp>"
    }
}

archive.available¶

録画保存ファイル出力

• data.start_timestamp
  • この録画が開始された時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.stop_timestamp
  • この録画が終了した時間(UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.start_time
  • この録画が開始された時間を UNIX 時間形式で表しています
• data.stop_time
  • この録画が終了した時間を UNIX 時間形式で表しています
• data.start_time_offset
  • StartRecording API を叩いてから何秒経過した後にこの録画が開始したかを表しています
• data.stop_time_offset
  • StartRecording API を叩いてから何秒経過した後にこの録画が終了したかを表しています
• data.stats
  • サポート向けに、録画に使用したパケット情報の統計を格納しています
  • 内部向け情報のため、予告なく変更されることがあります

{
    "type": "archive.available",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "session_id": "<Base32-UUIDv4>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "event_metadata": "<JSON>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "session_id": "<Base32-UUIDv4>",
        "client_id": "<String | Base32-UUIDv4>",
        "bundle_id": "<String | Base32-UUIDv4>",
        "connection_id": "<Base32-UUIDv4>",
        "created_at": "<Unix Time>",
        "file_path": "<String>",
        "filename": "<String>",
        "metadata_file_path": "<String>",
        "metadata_filename": "<String>",
        "size": "<Integer>",
        "audio": true,
        "audio_codec_type": "<String>",
        "video": true,
        "video_codec_type": "<String>",
        "video_bit_rate": "<Integer>",
        "video_height": "<Integer>",
        "video_width": "<Integer>",
        "stats": {},
        "start_time": "<Unix Time>",
        "start_time_offset": "<Integer>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_time": "<Unix Time>",
        "stop_time_offset": "<Integer>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
    }
}

split-archive.available¶

分割録画ファイル出力

• data.split_index
  • 分割された録画ファイルのインデックス
  • 0001 から始まり 9999 までいったら、その後は 10000, 10001 と増えていきます
• data.start_timestamp
  • 分割して出力された録画ファイルを開始された時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.stop_timestamp
  • 分割して出力された録画ファイルを終了した時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.start_time
  • 分割して出力された録画ファイルを開始した時間を UNIX 時間形式で表しています
• data.stop_time
  • 分割して出力された録画ファイルを終了した時間を UNIX 時間形式で表しています
• data.start_time_offset
  • この分割して出力された録画が、StartRecording API を叩いてから何秒経過した後に開始したかを表しています
• data.stop_time_offset
  • この分割して出力された録画が、StartRecording API を叩いてから何秒経過した後に終了したかを表しています
• data.stats
  • サポート向けに、録画に使用したパケット情報の統計を格納しています
  • 内部向け情報のため、予告なく変更されることがあります

{
    "type": "split-archive.available",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "session_id": "<Base32-UUIDv4>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "event_metadata": "<JSON>",
    "data": {
        "channel_id": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "split_index": "<String>",
        "session_id": "<Base32-UUIDv4>",
        "client_id": "<String | Base32-UUIDv4>",
        "bundle_id": "<String | Base32-UUIDv4>",
        "connection_id": "<Base32-UUIDv4>",
        "created_at": "<Unix Time>",
        "file_path": "<String>",
        "filename": "<String>",
        "metadata_file_path": "<String>",
        "metadata_filename": "<String>",
        "size": "<Integer>",
        "audio": true,
        "audio_codec_type": "<String>",
        "video": true,
        "video_codec_type": "<String>",
        "video_bit_rate": "<Integer>",
        "video_height": "<Integer>",
        "video_width": "<Integer>",
        "stats": {
        },
        "start_time": "<Unix Time>",
        "start_time_offset": "<Integer>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_time": "<Unix Time>",
        "stop_time_offset": "<Integer>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
    }
}

split-archive.end¶

分割録画終了

• data.start_time
  • 録画を開始した UNIX 時間形式で表しています
• data.stop_time
  • 録画を終了した UNIX 時間形式で表しています
• data.start_timestamp
  • 録画を開始した時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.stop_timestamp
  • 録画を終了した時間 (UTC) を RFC 3339 形式 (マイクロ秒) で表しています
• data.stats
  • サポート向けに、録画に使用したパケット情報の統計を格納しています
  • 内部向け情報のため、予告なく変更されることがあります

{
    "type": "split-archive.end",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "channel_id": "<String>",
    "session_id": "<Base32-UUIDv4>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "event_metadata": "<JSON>",
    "data": {
        "split_last_index": "<String>",
        "recording_id": "<Base32-UUIDv4>",
        "channel_id": "<String>",
        "session_id": "<Base32-UUIDv4>",
        "client_id": "<String | Base32-UUIDv4>",
        "bundle_id": "<String | Base32-UUIDv4>",
        "connection_id": "<Base32-UUIDv4>",
        "audio": true,
        "audio_codec_type": "<String>",
        "video": true,
        "video_codec_type": "<String>",
        "video_bit_rate": "<Integer>",
        "file_path": "<String>",
        "filename": "<String>",
        "stats": {},
        "start_time": "<Unix Time>",
        "start_time_offset": "<Integer>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_time": "<Unix Time>",
        "stop_time_offset": "<Integer>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
    }
}

archive.failed¶

録画ファイル保存失敗

{
    "type": "archive.failed",
    "id": "<Base32-UUIDv4>",
    "version": "<String>",
    "label": "<String>",
    "node_name": "<String>",
    "log_written": "<Boolean>",
    "timestamp": "<UTC RFC3339 Timestamp>",
    "channel_id": "<String>",
    "session_id": "<Base32-UUIDv4>",
    "client_id": "<String | Base32-UUIDv4>",
    "bundle_id": "<String | Base32-UUIDv4>",
    "connection_id": "<Base32-UUIDv4>",
    "event_metadata": "<JSON>",
    "data": {
        "recording_id": "<Base32-UUIDv4>",
        "session_id": "<Base32-UUIDv4>",
        "file_path": "<String>",
        "filename": "<String>",
        "audio": true,
        "audio_codec_type": "<String>",
        "video": true,
        "video_codec_type": "<String>",
        "video_bit_rate": "<Integer>",
        "video_height": "<Integer>",
        "video_width": "<Integer>",
        "stats": {},
        "start_time": "<Unix Time>",
        "start_timestamp": "<UTC RFC3339 Timestamp>",
        "stop_time": "<Unix Time>",
        "stop_timestamp": "<UTC RFC3339 Timestamp>",
    }
}

spotlight.focused¶

フォーカス設定

フォーカスされた際にウェブフックが飛びます。

{
  "type": "spotlight.focused",
  "channel_id": "<String>",
  "client_id": "<String | Base32-UUIDv4>",
  "bundle_id": "<String | Base32-UUIDv4>",
  "connection_id": "<Base32-UUIDv4>",
  "timestamp": "<UTC RFC3339 Timestamp>",
  "spotlight_number:": "<Integer>",
  "fixed": "<Boolean>",
  "id": "<Base32-UUIDv4>",
  "label": "<String>",
  "version": "<String>",
  "node_name": "<String>",
  "log_written": "<Boolean>",
  "audio": "<Boolean>",
  "video": "<Boolean>"
}

spotlight.unfocused¶

フォーカス解除

フォーカスが外れた際にウェブフックが飛びます。

{
  "type": "spotlight.unfocused",
  "channel_id": "<String>",
  "client_id": "<String | Base32-UUIDv4>",
  "bundle_id": "<String | Base32-UUIDv4>",
  "connection_id": "<Base32-UUIDv4>",
  "timestamp": "<UTC RFC3339 Timestamp>",
  "spotlight_number:": "<Integer>",
  "audio": "<Boolean>",
  "id": "<Base32-UUIDv4>",
  "label": "<String>",
  "version": "<String>",
  "node_name": "<String>",
  "log_written": "<Boolean>",
  "audio": "<Boolean>",
  "video": "<Boolean>"
}

connection.*¶

event_metadata¶