チャンネルイベントリストの照会

印刷する
共有
PDF

Article Summary

Share feedback

Thanks for sharing your feedback!

チャンネルイベントリストを照会する APIです。

リクエスト

GET https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/events

リクエストヘッダ

ヘッダ名	要否	説明
x-ncp-apigw-timestamp	YES	1970年1月1日00:00:00協定世界時(UTC)からの経過時間をミリ秒(Millisecond)で表し、 API Gatewayサーバとの時間差が5分以上の場合は、無効なリクエストとみなす `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	YES	NAVERクラウドプラットフォームポータルから発行された Access Key ID値 `x-ncp-iam-access-key:{Sub Account Access Key}`
x-ncp-apigw-signature-v2	YES	Access Key ID値と Secret Keyで暗号化した署名 `x-ncp-apigw-signature-v2:{API Gateway Signature}`
x-ncp-region_code	YES	リージョンコード(KR)

レスポンス

フィールド名	タイプ	説明
logLevel	String	INFO, ERROR
eventCode	String
description	String
timestamp	Integer

Event codeの詳細

eventCode	logLevel	タイプ	説明
STREAM_RESERVE	INFO	String	チャンネル作成済み
STREAM_UPDATE	INFO	String	チャンネル設定アップデート済み
PUBLISH_END	INFO	String	チャンネル配信終了
PUBLISH_START	INFO	String	チャンネル配信開始
THUMBNAIL_CREATE	INFO	String	チャンネルサムネイル作成済み
SIMULCAST_STATUS_CHANGE	INFO	String	ターゲットプラットフォーム状態アップデート済み
ONAIR_START	INFO	String	チャンネル録画開始
ONAIR_END	INFO	String	チャンネル録画終了
PUBLISH_OVER_THRESHOLD	INFO	String	チャンネルに流入するビットレートがしきい値を超えて配信
RTMP_MAIN_STREAM_ENABLED	INFO	String	メインストリーム配信が有効化状態
RTMP_BACKUP_STREAM_ENABLED	INFO	String	バックアップストリームにメイン送出が切り替わりました
BACKUP_SESSION_STREAMING_CONNECTED	INFO	String	バックアップストリームの送信が開始されました
BACKUP_SESSION_STREAMING_DISCONNECTED	INFO	String	バックアップストリームの送信が終了しました
STREAM_FINISH	INFO	String	チャンネル使用不可詳細は、カスタマーサポートまでお問い合わせ
AVG_BPS_LOW_WARN	INFO	String	チャンネルに流入するビットレートが不安定な状態配信状態確認必要
ERROR	ERROR	String	チャンネル配信が正常ではない配信状態確認
STREAM_BLOCKED_ON_LIVE	ERROR	String	チャンネル配信が不安定でチャンネル使用停止約5分間チャンネル使用停止
STREAM_BLOCKED_AT_START	ERROR	String	特定配信オプションによりチャンネル使用停止約30分間チャンネル使用停止
STREAM_BLOCKED_UNDEFINED	ERROR	String	不明な理由により、チャンネルの使用が停止されました。約1時間チャンネル使用停止
STREAM_UNBLOCK	ERROR	String	チャンネル停止状態が解除再配信後に使用可能
STREAM_UNBLOCK_BY_MANUALLY	INFO	String	チャンネル使用停止が解除
STREAM_UNBLOCK_FAILED	ERROR	String	チャンネル停止状態の解除失敗カスタマーサポートまでお問い合わせ
STREAM_BLOCKED_BY_MANUALLY	ERROR	String	チャンネル使用停止
PROCESSING_FAIL	ERROR	String	不明な理由により、レコーディングファイルの作成に失敗
FAIL_RELAY	ERROR	String	不明な理由により、配信に失敗
FAIL_ONAIR	ERROR	String	不明な理由により、レコーディング開始不可
FAIL_STOP	ERROR	String	不明な理由により、レコーディング終了不可
FAIL_FINISH	ERROR	String	不明な理由により、配信中止に失敗
FAIL_FORCE	ERROR	String	不明な理由により、配信中止に失敗
FAIL_RELEASE	ERROR	String	不明な理由により、配信中止に失敗
PP_STOP_FAIL	ERROR	String	不明なエラーが発生
NO_SPS_PPS	ERROR	String	Videoパケット流入が正常ではない
AUDIO_INFO_CHANGED	ERROR	String	Re-Streamチャンネルの Audioパケット流入が正常ではない
VIDEO_INFO_CHANGED	ERROR	String	Re-Streamチャンネルの Videoパケット流入が正常ではない
FAILED_TO_PARSE_METADATA	ERROR	String	Re-Streamチャンネルに流入した Video、Audioパケットを読み取れない
UNSUPPORTED_MEDIA_CODEC	ERROR	String	配信中のコーデックはサポートしない
INCORRECT_KEY_INTERVAL	ERROR	String	流入した Keyframe intervalが4秒以上
UNSUPPORTED_AUDIO_FRAMERATE	ERROR	String	流入した Audio FrameRateが異常に大きい
UNSUPPORTED_VIDEO_FRAMERATE	ERROR	String	流入した Video FrameRateが異常に大きい
UNSUPPORTED_AUDIO_BITRATE	ERROR	String	流入した Audio Bitrateが異常に大きい
UNSUPPORTED_VIDEO_BITRATE	ERROR	String	流入した Video Bitrateが異常に大きい
UNSUPPORTED_VIDEO_RESOLUTION	ERROR	String	流入した Video Bitrateが異常に大きい
TOO_MANY_DISCONNECTION	ERROR	String	コネクションが非常に不安定
RACE_DISCONNECTION	ERROR	String	直近30秒以内に重複配信による頻繁なコネクション競合が発生
PREROLL_FAILED	ERROR	String	5分間、Audio/Videoのいずれかのパケット流入が正常ではない状態
LARGE_READ_TIME_GAP	ERROR	String	コネクション後、約10秒ほど Video、Audioパケットが流入していない
UNEXPECTED_CONNECTION_ERROR	ERROR	String	不明な理由により、配信が終了
LARGE_AUDIO_VIDEO_TIME_GAP	ERROR	String	流入した Audio/Videoパケット間の timestamp差が異常
FAILED_TO_ALLOC_MEM	ERROR	String	不明な理由により、配信が終了
AUDIO_OVERRUN	ERROR	String	流入した Audioパケットとトランスコーディング Audioパケットの timestamp間の差が異常
VIDEO_OVERRUN	ERROR	String	流入した Videoパケットとトランスコーディング Videoパケットの timestamp間の差が異常
UNKNOWN	ERROR	String	UNKNOWN

例

リクエスト例

GET /api/v2/channels/ls-20200313162828-G60tN/events
HOST: livestation.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-timestamp:1521787414578
x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
x-ncp-region_code:KR

レスポンス例

HTTP/1.1 200 OK
Server: nginx
Date: Wed, 12 Sep 2018 09:53:32 GMT
Content-Type: application/json;charset=utf-8
Connection: keep-alive
Access-Control-Allow-Origin: *
x-ncp-trace-id: 36c9k60om4p3238cpmc9gm4cj4

{
    "content" : [
        {
            "logLevel" : "INFO",
            "eventCode" : "PUBLISH_START",
            "description" : "You have started publishing channel ls-20200313162828-G60tN.",
            "timestamp" : 1585572599000
        },
        {
            "logLevel" : "INFO",
            "eventCode" : "PUBLISH_END",
            "description" : "ls-20200313162828-G60tN channel publishing has ended.",
            "timestamp" : 1585559611000
        },
        {
            "logLevel" : "INFO",
            "eventCode" : "ONAIR_END",
            "description" : "ls-20200313162828-G60tN Channel recording has ended.",
            "timestamp":1585559598000
        }
    ],
    "total" : 3
}

この記事は役に立ちましたか?

What's Next

チャンネル送出イベントリスト照会

リクエスト
レスポンス
例

タグ

Live Station