본문은 사용자 지정 녹음 방식으로 GME 서버 녹음 기능을 빠르게 통합할 수 있도록 도와줍니다.
시나리오
GME는 실시간 음성 채팅 스트림을 위한 서버 녹음 기능을 제공하여 개발자가 콘텐츠 보관, 콘텐츠 관리 및 콘텐츠 재생산과 같은 시나리오를 구현할 수 있도록 지원합니다. 전체 녹음: 애플리케이션 내 전체 음성 녹음과 방별 혼합 스트림, 사용자별 단일 스트림을 지원합니다. 사용자 지정 녹음: 지정된 방의 방별 혼합 스트림, 사용자별 단일 스트림을 지원합니다. 녹음된 오디오 파일은 귀하의 계정에 있는 COS 서비스에 저장됩니다.
본문은 사용자 지정 녹음의 개발 및 통합 방법에 대해서만 설명합니다. 애플리케이션에 전체 녹음을 활성화하려면 개발 가이드 - 전체 녹음을 참고하십시오.
주의사항：
GME 서버 녹음 기능을 사용하면 녹음 과정에서 GME에서 녹음 서비스 요금이 발생합니다. GME 글로벌 포털 녹음 서비스는 2023년 4월 1일부터 정식 과금될 예정이며, 자세한 내용은 GME 구매 가이드에 공지됩니다.
녹음된 파일은 Tencent Cloud 계정의 COS 서비스에 저장되며 저장 용량, 저장 기간 및 액세스 빈도 등 고객의 구체적인 사용 방식에 따라 COS 청구서가 발행됩니다. 자세한 내용은 COS 과금 개요를 참고하십시오.
이 API를 통해 taskid의 녹음 유형 업데이트, 얼로우리스트 사용자 ID 또는 블록리스트 사용자 ID 업데이트 등 녹음 정보를 업데이트할 수 있습니다. taskid를 기록하지 않은 경우 DescribeTaskInfo()를 통해 지정된 방에서 진행 중인 녹음 작업의 taskid를 가져와야 합니다.
GME 서버 녹음 파일은 귀하의 계정에 있는 COS 서비스의 지정된 버킷에 저장됩니다. 버킷의 리전은 귀하가 지정합니다. 선택 가능한 리전 목록은 리전 및 액세스 도메인을 참고하십시오.
5. 녹음 파일 형식
.mp3
6. 녹음 파일 이름 생성 규칙
사용자 단일 스트림 녹음 파일: bizid_roomid_userid/${작업 시작 시간}_${id}_audio.mp3
방 혼합 스트림 녹음 파일: bizid_roomid/${taskid}${작업 시작 시간}${id}_audio.mp3
bizid: GME 애플리케이션 ID입니다. GME 콘솔에서 가져올 수 있습니다.
roomid: 음성 방 ID입니다. 실시간 음성 채팅 서비스 이용 시 정의되어 GME SDK로 전달됩니다.
userid: 플레이어 ID입니다. 실시간 음성 채팅 서비스 이용 시 정의되어 GME SDK로 전달됩니다.
taskid: GME 녹음 서비스에서 생성한 녹음 작업 ID입니다. 각 녹음 작업에는 고유한 작업 ID가 있습니다.
id: 녹음 작업을 위한 세그먼트의 일련 번호입니다. 초기 일련 번호는 0입니다.
GME 콘솔에 로그인하여 [서비스 관리] 메뉴로 들어가 녹음 서비스를 활성화할 애플리케이션의 [설정]을 클릭하여 애플리케이션 상세 페이지로 이동합니다.
녹음 서비스 활성화/비활성화
페이지의 [음성 녹음 서비스]에서 수정을 클릭하고 녹음 스위치를 ON으로 설정합니다.
녹음 서비스를 처음 시작할 때 GME는 귀하의 COS 서비스에 액세스하기 위해 귀하에게 서비스 승인을 신청합니다. 팝업 창 페이지에서 권한 부여에 동의해주셔야 정상적으로 서버 녹음 서비스를 이용하실 수 있습니다.
녹음 파일 저장 구성
녹음 파일 버킷에서 바인딩을 클릭합니다.
스토리지 버킷 바인딩 팝업 창에서 기존 COS 스토리지 버킷(COS 콘솔에서 사전에 생성한 버킷)을 바인딩하거나 새로운 스토리지 버킷을 생성할 수 있습니다.
녹음 이벤트 콜백 설정(선택 사항)
녹음 서비스의 이벤트 콜백을 받으려면 콜백 주소를 설정합니다. 작업 경로: 애플리케이션 세부 정보 페이지 이동 후 해당 페이지의 [음성 녹음 서비스] 수정을 클릭하고, 콜백 주소에서 수정 클릭한 후 팝업 창에 콜백을 받을 url 주소를 입력합니다. 현재 녹음 작업 완료 상태 이벤트 콜백 메시지만 푸시됩니다.
녹음 범위 구성
녹음 범위는 사용자 지정 녹음 또는 전체 녹음 중에서 선택할 수 있습니다. 사용자 지정 녹음을 선택해야 합니다. 그렇지 않으면 서버에서 관련 API를 호출할 수 없습니다.
상기 구성을 완료한 후 저장을 클릭하면 녹음 서비스가 시작됩니다. 더 이상 녹음 서비스를 사용할 필요가 없으면 예기치 않은 요금이 발생되지 않도록 콘솔에서 녹음 서비스 스위치를 OFF로 설정하십시오.
2단계: 녹음 작업 콜백 수신(선택 사항)
1단계에서 콜백 주소를 설정한 경우 녹음 작업 이벤트 콜백을 받을 수 있습니다.
3단계: 서버 API 호출 및 녹음 범위 정의
비즈니스 시나리오의 실제 요구 사항에 따라 관련 API를 호출합니다. 호출 순서 및 프로세스 설계 시 다음 사항에 주의하십시오.
(1) 이미 존재하는 RoomId에만 녹화 시작 요청을 전송할 수 있습니다. RoomId가 없으면 녹음 작업이 생성되지 않습니다.
(2) 직접 녹음 중지를 호출하지 않는 한 방에 사용자가 있으면 녹음 프로세스가 지속됩니다. 방에 있는 모든 사용자가 퇴장한 경우 기존 녹음 작업 프로세스는 12시간 동안 지속됩니다. 이 시간 동안 사용자가 방에 다시 입장하면 녹음이 자동으로 시작됩니다. 녹음 프로세스의 지속 시간이 끝난 후에 사용자가 방에 입장하면 녹음이 자동으로 시작되지 않습니다.
4단계: 녹음 파일 조회/관리
녹음 작업이 끝난 후 몇 분 안에 오디오 파일이 생성됩니다. COS 콘솔에 로그인하여 녹음된 파일을 조회 및 관리할 수 있습니다.
예
아니오
문제 해결에 도움이 되었나요?