- 릴리스 노트
- 제품 소개
- 사용자 튜토리얼
- 구매 가이드
- SDK 다운로드 가이드
- 제품 기능 데모
- 콘솔 가이드
- 시작하기
- 기본 기능 개발 가이드
- 고급 기능 개발 가이드
- 클라이언트 API
- Server APIs
- FAQ
- Service Agreement
- 문의하기
- 용어집
- GME 정책
- 릴리스 노트
- 제품 소개
- 사용자 튜토리얼
- 구매 가이드
- SDK 다운로드 가이드
- 제품 기능 데모
- 콘솔 가이드
- 시작하기
- 기본 기능 개발 가이드
- 고급 기능 개발 가이드
- 클라이언트 API
- Server APIs
- FAQ
- Service Agreement
- 문의하기
- 용어집
- GME 정책
서버 녹음 콜백 설명
설명
네트워크의 영향을 받아 서버가 알림을 받는 순서와 이벤트가 발생하는 순서가 정확히 일치하지 않을 수 있습니다.서비스에는 재시도 메커니즘이 있지만 모든 메시지가 도달한다는 보장이 없습니다.상기 두 가지 사항을 고려할 때 비즈니스의 핵심 비즈니스 로직이 메시지 알림 서비스에 의존하는 것은 권장되지 않습니다.
네트워크 프로토콜
콘솔에서 콜백 주소, 즉 HTTP(S) 프로토콜 API의 URL을 설정한 경우 POST 요청을 지원해야 하며 전송 데이터 인코딩은 UTF-8을 채택합니다.
HTTP 헤더 매개변수
이름 | 유형 | 필수 여부 | 설명 |
Signature | string | Yes |
서명 생성
Signature = HMAC-SH1 ( strContent, SecretKey )
strContent: body의 전체 JSON 콘텐츠(길이는 Content-Length 기준)인 서명 문자열입니다.
body: 비즈니스로 콜백되는 JSON 콘텐츠로, 아래 콜백 예시의 전체 콘텐츠가 body입니다.
SecretKey: 키. 애플리케이션의 권한 키로, 콘솔 > 애플리케이션 상세 정보를 통해 확인할 수 있습니다.
HMAC-SH1: 서명 알고리즘입니다.
콜백 매개변수
이름 | 유형 | 설명 |
BizID | Integer | |
RoomID | String | 방 ID |
UserID | String | 사용자 ID |
RecordMode | Integer | 녹음 모드 0: 단일 스트림 1: 혼합 스트림 |
Timestamp | Integer | 콜백 전송 시의 타임스탬프(s) |
TaskID | Integer | 클라우드 녹음 서비스에서 할당한 작업 ID입니다. 작업 ID는 녹음의 라이프사이클 프로세스에 대한 고유 식별자이며 녹음이 종료되면 의미를 잃습니다. 사용자 지정 녹음 모드를 사용하면,작업 ID는 녹음이 시작될 때 응답 매개변수를 통해 얻을 수 있으며, 비즈니스에서 저장해 두어야 합니다. 이는 이번 녹음 작업에 대한 다음 번 작업의 요청 매개변수 입니다. |
EventType | Integer | 이벤트 유형 |
Detail | 이벤트 세부 정보, 형식은 EventType에 의해 결정됩니다 |
EventDetail 이벤트 세부 정보 설명
EventType | 설명 | Detail |
1 | 오디오 파일 녹음 시작 | SeqNo: Number, 세그먼트 시리얼 넘버 FileName: String, 파일 이름 |
2 | 오디오 파일 녹음 완료 | SeqNo: Number, 세그먼트 시리얼 넘버 FileName: String, 파일 이름 |
3 | 오디오 파일 업로드 완료 | SeqNo: Number, 세그먼트 시리얼 넘버 FileName: String, 파일 이름 |
콜백 예시
{"BizID":1400000000,"RoomID":"100","UserID":"999","TaskID":446946705284000000,"RecordMode":1,"Timestamp":1675930605,"EventType":1,"Detail":{"SeqNo":0,"FileName":"1400000000_100_999/2023-02-09-16-16-45_446946705284000000_audio.mp3"}}
예
아니오
문제 해결에 도움이 되었나요?