채널 이벤트 목록 조회
    • PDF

    채널 이벤트 목록 조회

    • PDF

    기사 요약

    채널 이벤트 목록을 조회하는 API 입니다.

    요청

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

    요청 헤더

    헤더명필수 여부설명
    x-ncp-apigw-timestampYES1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타내며 API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
    x-ncp-apigw-timestamp:{Timestamp}
    x-ncp-iam-access-keyYES네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값
    x-ncp-iam-access-key:{Sub Account Access Key}
    x-ncp-apigw-signature-v2YESAccess Key ID 값과 Secret Key로 암호화한 서명
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    x-ncp-region_codeYES리전 코드 (FKR)

    응답

    필드명타입설명비고
    logLevelStringINFO, ERROR
    eventCodeString
    descriptionString
    timestampInteger

    Event code 상세

    eventCodelogLevel타입설명
    STREAM_RESERVEINFOString채널 생성
    STREAM_UPDATEINFOString채널 설정이 업데이트됨
    PUBLISH_ENDINFOString채널 송출 종료
    PUBLISH_STARTINFOString채널 송출 시작
    THUMBNAIL_CREATEINFOString채널 섬네일이 생성됨
    SIMULCAST_STATUS_CHANGEINFOString타겟 플랫폼 상태가 업데이트됨
    ONAIR_STARTINFOString채널 녹화 시작
    ONAIR_ENDINFOString채널 녹화 종료
    PUBLISH_OVER_THRESHOLDINFOString채널로 유입되는 비트레이트가 임계치를 초과하여 송출
    RTMP_MAIN_STREAM_ENABLEDINFOString메인 스트림 송출 활성화 상태
    RTMP_BACKUP_STREAM_ENABLEDINFOString백업 스트림으로 메인 송출이 전환됨
    BACKUP_SESSION_STREAMING_CONNECTEDINFOString백업 스트림 송출이 시작됨
    BACKUP_SESSION_STREAMING_DISCONNECTEDINFOString백업 스트림 송출이 종료됨
    STREAM_FINISHINFOString채널 사용 불가 (자세한 사항은 고객 센터로 문의 바람)
    AVG_BPS_LOW_WARNINFOString채널로 유입되는 비트레이트가 불안정한 상태 (송출 상태 확인 바람)
    ERRORERRORString채널 송출이 정상적이지 않음 (송출 상태 확인 바람)
    STREAM_BLOCKED_ON_LIVEERRORString채널 송출이 불안정하여 채널 사용 정지 (약 5분간 채널 사용 정지)
    STREAM_BLOCKED_AT_STARTERRORString특정 송출 옵션으로 인해 채널 사용 정지 (약 30 분간 채널 사용 차단)
    STREAM_BLOCKED_UNDEFINEDERRORString알 수 없는 이유로 채널 사용 정지 (약 1시간 채널 사용 정지)
    STREAM_UNBLOCKERRORString채널 정지 상태가 해지됨
    재송출 후 사용 가능
    STREAM_UNBLOCK_BY_MANUALLYERRORString채널 사용 정지가 해지됨
    STREAM_UNBLOCK_FAILEDERRORString채널 정지 상태 해지 실패
    고객 센터로 문의 바람
    STREAM_BLOCKED_BY_MANUALLYERRORString채널 사용 정지
    FAIL_RELAYERRORString알 수 없는 이유로 송출 실패
    FAIL_ONAIRERRORString알 수 없는 이유로 레코딩 시작 불가
    FAIL_STOPERRORString알 수 없는 이유로 레코딩을 종료 불가
    FAIL_FINISHERRORString알 수 없는 이유로 송출 중단 실패
    FAIL_FORCEERRORString알 수 없는 이유로 송출 중단 실패
    FAIL_RELEASEERRORString알 수 없는 이유로 송출 중단 실패
    PROCESSING_FAILERRORString알 수 없는 이유로 레코딩 파일 생성 실패
    NO_SPS_PPSERRORStringVideo 패킷 유입이 정상적이지 않음
    AUDIO_INFO_CHANGEDERRORStringRe-Stream 채널 Audio 패킷 유입이 정상적이지 않음
    VIDEO_INFO_CHANGEDERRORStringRe-Stream 채널 Video 패킷 유입이 정상적이지 않음
    FAILED_TO_PARSE_METADATAERRORStringRe-Stream 채널로 유입된 Video, Audio 패킷을 읽을 수 없음
    UNSUPPORTED_MEDIA_CODECERRORString송출중인 코덱은 지원하지 않음
    INCORRECT_KEY_INTERVALERRORString인입 Keyframe interval 이 4초 이상
    UNSUPPORTED_AUDIO_FRAMERATEERRORString인입 Audio FrameRate 가 비정상적으로 큼
    UNSUPPORTED_VIDEO_FRAMERATEERRORString인입 Video FrameRate 가 비정상적으로 큼
    UNSUPPORTED_AUDIO_BITRATEERRORString인입 Audio Bitrate 가 비정상적으로 큼
    UNSUPPORTED_VIDEO_BITRATEERRORString인입 Video Bitrate 가 비정상적으로 큼
    UNSUPPORTED_VIDEO_RESOLUTIONERRORString인입 Video Bitrate 가 비정상적으로 큼
    TOO_MANY_DISCONNECTIONERRORString커넥션이 매우 불안정
    RACE_DISCONNECTIONERRORString최근 30초 이내 중복 송출로 인한 잦은 커넥션 충돌 발생
    PREROLL_FAILEDERRORString5분 동안 Audio/Video 중 한쪽 패킷 유입이 정상적이지 않은 상태
    LARGE_READ_TIME_GAPERRORString커넥션 이후 약 10초가량 Video,Audio 패킷이 유입되지 않았음
    UNEXPECTED_CONNECTION_ERRORERRORString알 수 없는 원인으로 송출 종료
    LARGE_AUDIO_VIDEO_TIME_GAPERRORString유입된 Audio/Video 패킷간 timestamp 차이가 비정상적
    FAILED_TO_ALLOC_MEMERRORString알 수 없는 원인으로 송출 종료
    AUDIO_OVERRUNERRORString유입된 Audio 패킷과 트랜스코딩 Audio 패킷 timestamp 간 차이가 비정상적
    VIDEO_OVERRUNERRORString유입된 Video 패킷과 트랜스코딩 Video 패킷 timestamp 간 차이가 비정상적
    UNKNOWNERRORStringUNKNOWN

    예시

    요청 예시

    GET /api/fin-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:FKR
    

    응답 예시

    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
    }
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.