채널 이벤트 목록 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

채널 이벤트 목록을 조회하는 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	네이버 클라우드 플랫폼 포털에서 발급받은 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 패킷과 트랜스코딩 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