MENU
      레코딩 시작

        레코딩 시작


        기사 요약

        Live Station 채널에 인입되는 영상의 레코딩을 시작하는 API 입니다. 채널이 송출중(Publish) 상태일때만 사용할 수 있습니다.

        요청

        PUT https://livestation.apigw.ntruss.com/api/v2/channels/{channelId}/startRecord
        HTTP

        요청 헤더

        헤더명필수 여부설명
        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리전 코드 (KR)

        응답

        필드명타입설명비고
        recordListObject
        recordIdsObject
        recordTypeStringMP4, HLS
        channelIdString
        statusStringRECORDING, PROCESSING, PROCESSING_FAIL, TRANSFER_READY, TRANSFER, TRANSFER_FINISH, TRANSFER_FAIL, DELETED
        recordSeqInteger
        streamSeqInteger
        recordBeginTimeInteger
        createdTimeInteger
        shouldDeleteTimeInteger
        resolutionString
        fileNameString
        durationInteger단위: Second
        videoBitrateInteger
        videoFrameRateFloat
        audioBitrateInteger
        audioCodecString
        uploadPathString
        objectStorageUrlString업로드가 되지 않은 상태에서는 "-"

        예시

        요청 예시

        PUT /api/v2/channels/ls-20210406135408-FNGOA/startRecord
        HOST: livestation.apigw.ntruss.com
        Content-Type: application/json
        x-ncp-apigw-timestamp:1621238887953
        x-ncp-iam-access-key:6uxz1nKkcYwUjWRG5Q1V7NsW0i5jErlu2NjBXXgy
        x-ncp-apigw-signature-v2:iJFK773KH0WwQ79PasqJ+ZGixtpDQ/abS57WGQdld2M=
        x-ncp-region_code:KR
        HTTP

        응답 예시

        HTTP/1.1 200 OK
        Server: nginx
        Date: Mon, 17 May 2021 08:08:08 GMT
        Content-type: application/json;charset=UTF-8
        Connection: keep-alive
        X-ncp-trace-id: 3adhn65i30o9o36cr1ccp62or5
        
        {
          "content": {
            "recordList": {
              "27195": {
                "recordType": "MP4",
                "channelId": "ls-20210406135408-FNGOA",
                "status": "RECORDING",
                "recordSeq": 123175,
                "streamSeq": 138717,
                "recordBeginTime": 1621238888000,
                "createdTime": 1621238888000,
                "shouldDeleteTime": 1621843688000,
                "fileName": "138717-123175-202105171708.mp4",
                "uploadPath": "live-station/record/ls-20210406135408-FNGOA/138717-123175-202105171708.mp4",
                "objectStorageUrl": "-"
              },
              "27196": {
                "recordType": "HLS",
                "channelId": "ls-20210406135408-FNGOA",
                "status": "RECORDING",
                "recordSeq": 123175,
                "streamSeq": 138717,
                "recordBeginTime": 1621238888000,
                "createdTime": 1621238888000,
                "shouldDeleteTime": 1621843688000,
                "resolution": "0x0",
                "fileName": "bypass/playlist.m3u8",
                "videoBitrate": 299008,
                "audioBitrate": 128000,
                "videoFrameRate": 30,
                "audioCodec": "AAC",
                "uploadPath": "live-station/record/ls-20210406135408-FNGOA/bypass/123175",
                "objectStorageUrl": "-"
              }
            }
          },
          "total": 2
        }
        HTTP

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

        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.