リクエスト

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	ERROR	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パケットとトランスコーディング Videoパケットの 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
}

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

リクエスト
- リクエストヘッダ
レスポンス
- Event codeの詳細
例
- リクエスト例
- レスポンス例

タグ

Live Station