본 섹션은 전자상거래 라이브 방송 업무 시나리오에서 일반적으로 사용되는 업무 프로세스를 종합하여 전체 시나리오 구현 프로세스를 더 잘 이해할 수 있도록 도와줍니다.
스트리머의 방송 시작 및 종료
스트리머 간 크로스 룸 PK 연결
RTC 시청자 방 입장 후 마이크 연결합니다
판매 상품의 관리
아래 그림으로 스트리머(방주인)의 로컬 미리보기, 방 생성, 방 입장하여 방송 시작, 방 퇴장 및 방송 종료 프로세스를 보여줍니다.
아래 그림으로 스트리머 A가 스트리머 B를 초청하여 크로스 룸 PK 연결을 진행하는 프로세스를 보여줍니다. 크로스 룸 PK 과정에서 두 방의 시청자 모두 두 방주인의 PK 연결 라이브 방송 화면을 볼 수 있습니다.
아래 그림으로 RTC 실시간 인터랙션 라이브 방송실에서 시청자의 방 입장, 마이크 연결 신청, 연결 종료, 방 퇴장 프로세스를 보여줍니다.
아래 그림으로 라이브 커머스 시나리오에서 스트리머가 상품을 편집하고 상품 링크 올리며, 시청자가 상품을 보고 구매하는 프로세스를 보여줍니다.
접근 준비
단계1: 서비스 개통
전자상거래 라이브 방송 시나리오는 일반적으로 RTC Engine, 뷰티 AR, 플레이어 SDK와 같은 유료 PaaS 서비스를 활용하여 구축됩니다. 이 중 RTC Engine은 실시간 음성 및 영상 인터랙티브 기능을 제공하고 뷰티 AR은 뷰티 효과 기능을 제공하며, 플레이어는 라이브 및 VOD 재생 기능을 제공합니다. 실제 업무 요구에 따라 위 서비스를 자유롭게 선택하여 개통할 수 있습니다.
RTC Engine 서비스의 개통
뷰티 AR 서비스의 개통
플레이어 서비스의 개통
1. 먼저 RTC Engine 콘솔에 로그인하여 애플리케이션을 생성해야 합니다. 필요에 따라 RTC Engine 애플리케이션 버전을 업그레이드할 수 있으며, 예를 들어 프로페셔널 버전은 더 많은 부가 기능 서비스를 이용할 수 있습니다.
설명:
두 개의 애플리케이션을 생성하고 각각 테스트 환경과 프로덕션 환경에 적용하는 것을 권장하며, 1년 동안 각 텐센트 클라우드 계정(UIN)에 매월 10,000분의 무료 사용 시간이 제공됩니다.
RTC Engine 월정액 요금제는 체험판(기본), 라이트 버전, 스탠다드 버전, 프로페셔널 버전으로 구분되며, 각각 다른 부가 기능 서비스를 이용할 수 있습니다. 자세한 내용은 버전 기능 및 월정액 요금제 설명을 참조하세요.
2. 애플리케이션 생성이 완료되면, 앱 관리 - 앱 개요 섹션에서 해당 애플리케이션의 기본 정보를 확인할 수 있습니다. 향후 사용을 위해 SDKAppID와 SDKSecretKey를 안전하게 보관해야 하며, 키 유출로 인한 트래픽 도용을 방지해야 합니다.
1. 뷰티 AR 콘솔 > 모바일 라이선스에 로그인한 후 테스트 라이선스 생성을 클릭하세요(테스트판 라이선스는 무료로 14일간 유효하며, 1회 연장 가능하여 총 28일 사용할 수 있습니다). 모바일을 선택하고 실제 필요에 따라 앱 이름, 패키지 이름 및 번들 ID를 입력하세요. 사용해 보고 싶은 기능을 선택하세요.예를 들어 모든 뷰티 기능, 가상 배경, 얼굴 인식, 제스처 인식, 선물 애니메이션 효과등, 그런 다음 확인를 클릭하세요.
2. 활성화 후 현재 페이지에서 손님의 정보를 확인하고 상단의 통합 가이드를 참조하여 통합시킬 수 있습니다. 통합 가이드에서 License Key와 License URL 사용 방법을 확인할 수 있습니다.
1. VOD 콘솔 또는 라이브 콘솔 > 라이선스 관리 > 모바일 라이선스에 로그인한 후 테스트 라이선스 생성를 클릭하세요.
2. 실제 요구 사항에 따라 App Name, Package Name, Bundle Id를 입력하고 플레이어 고급판을 선택한 후 생성를 클릭하세요.
3. 테스트판 라이선스가 성공적으로 생성되면 페이지에 생성된 라이선스 정보가 표시됩니다. SDK 초기화 설정 시 License Key와 License URL 두 가지 매개변수를 전달해야 하므로 다음 정보를 안전하게 보관하세요.
주의:
동일한 앱의 라이선스 URL과 Key는 고유하며, 테스트판 라이선스가 정식판으로 업그레이드된 후에도라이선스 URL과 Key는 변경되지 않습니다.
단계2: SDK 임포트하기
RTC Engine SDK, 뷰티 AR SDK, 플레이어 SDK는 모두 mavenCentral 라이브러리에 릴리스되었으며, gradle을 구성하여 자동으로 다운로드 및 업데이트할 수 있습니다.
1. dependencies에 적합한 버전의 SDK 종속성을 추가합니다.
dependencies {
// 전체 기능판 SDK에 RTC Engine, 라이브 방송, 쇼트 비디오, 플레이어 등 다양한 기능 포함됩니다
전자상거래 라이브 방송 시나리오의 구현은 일반적으로 RTC Engine, 플레이어 등 여러 기능의 조합이 필요하며, 개별 통합 시 발생할 수 있는 신호 충돌 문제를 방지하기 위해 전체 기능판 SDK 통합을 권장합니다.
2. defaultConfig에서 앱이 사용하는 CPU 아키텍처를 지정합니다.
defaultConfig {
ndk {
abiFilters "armeabi-v7a","arm64-v8a"
}
}
설명:
LiteAVSDK 전체 기능판은 armeabi-v7a/arm64-v8a/x86/x86_64 아키텍처를 지원하며, 뷰티 AR SDK는 armeabi-v7a/arm64-v8a 아키텍처만 지원합니다.
3. Sync Now을 클릭하면 SDK가 자동으로 다운로드되어 프로젝트에 통합됩니다. 뷰티 AR 패키지에 모션 효과와 필터 기능이 포함된 경우 SDK 다운로드 페이지에서 해당 패키지를 다운로드하고, 무료 필터 소스(./assets/lut)와 스티커 모션(./MotionRes)을 압축 해제한 후 프로젝트의 다음 디렉터리에 배치해야 합니다.
모션 효과: ../assets/MotionRes
필터 효과: ../assets/lut
단계 3: 엔지니어링 구성
1. 권한의 구성. AndroidManifest.xml에서 앱 권한을 구성하며 전자상거래 라이브 방송 시나리오에서 RTC Engine 및 뷰티 AR SDK에는 다음 권한이 필요합니다:
android:hardwareAccelerated="false"를 설정하지 마십시오. 하드웨어 가속을 끄면 상대방의 비디오 스트림이 렌더링되지 않습니다.
RTC Engine SDK에는 내장된 권한 요청 로직이 없으므로 해당 권한을 직접 선언해야 하며, 일부 권한(예: 저장소, 레코딩, 카메라 등)은 런타임에 동적으로 신청해야 합니다.
Android 프로젝트의 targetSdkVersion이 31이거나 대상 기기가 Android 12및 그 이상 시스템 버전과 관련된 경우, 블루투스 기능을 정상적으로 사용하기 위해 코드에서 android.permission.BLUETOOTH_CONNECT 권한을 동적으로 신청해야 합니다. 자세한 내용은 블루투스 권한를 참조하십시오.
2. 혼합 스트림의 구성. SDK 내부에서 Java의 리플렉션 기능을 사용하므로 proguard-rules.pro 파일에서 SDK 관련 클래스를 난독화 제외 목록에 추가해야 합니다.
-keep class com.tencent.**{*;}
-keep class org.light.**{*;}
-keep class org.libpag.**{*;}
-keep class org.extra.**{*;}
-keep class com.gyailib.**{*;}
-keep class androidx.exifinterface.**{*;}
단계4: 인증 및 허가
RTC Engine 인증 자격 증명
뷰티 AR 인증 허가
플레이어 라이선스의 인증
UserSig는 텐센트 클라우드에서 설계한 보안 서명이고 악의적인 공격자가 손님의 클라우드 서비스 사용 권한을 도용하는 것을 방지하기 위한 것입니다. RTC Engine은 방 입장 시 이를 인증합니다.
디버깅 및 테스트 단계: 클라이언트 예시 코드와 콘솔에서 가져오기 두 가지 방법으로 UserSig를 계산 및 생성할 수 있으며, 디버깅 및 테스트 용도로만 사용됩니다.
정식 운영 단계: 클라이언트가 역공학으로 키가 유출되는 것을 방지하기 위해 보안 등급이 더 높은 서버 UserSig 계산 방식의 사용을 권장합니다.
구체적인 구현 프로세스는 다음과 같습니다.
1. 손님의 App은 SDK 초기화 함수를 호출하기 전에 먼저 서버에 UserSig를 요청해야 합니다.
관련 업무 모듈의 초기화 코드에서 인증 허가를 트리거하고 사용하기 전에 임시로 라이선스를 다운로드하는 것을 피하며, 인증 시에는 네트워크 권한이 있어야 합니다.
실제 적용된 패키지 이름은 라이선스 생성 시 바인딩된 Package Name과 완전히 일치해야 하며, 그렇지 않으면 라이선스 검증이 실패할 수 있습니다. 자세한 내용은 인증 오류 코드을 참조하세요.
라이브 방송의 재생 및 VOD 재생 기능은 플레이어 라이선스 권한을 구성한 후에야 성공적으로 재생할 수 있으며, 그렇지 않으면 재생에 실패합니다(검은 화면). 전역적으로 한 번만 설정하면 됩니다. 아직 라이선스를 획득하지 않으셨다면 무료 테스트 버전 라이선스 신청을 통해 정상적으로 재생할 수 있으며, 정식 버전 라이선스는 구매가 필요합니다. 라이선스 신청이 성공하면 라이선스 URL와 라이선스 key 두 개의 문자열을 받게 됩니다.
앱에서 SDK 관련 기능을 호출하기 전에 다음과 같이 구성해야 합니다(Application 클래스에서 구성하는 것이 좋습니다).
라이선스 설정이 완료되면(네트워크 상황에 따라 조금 시간이 소요될 수 있음) 다음과 같은 방법으로 라이선스 정보를 확인할 수 있습니다.
TXLiveBase.getInstance().getLicenceInfo();
주의:
실제 적용된 패키지 이름은 라이선스 생성 시 바인딩된 Package Name과 완전히 일치해야 하며, 그렇지 않으면 라이선스 검증이 실패할 수 있습니다.
라이선스는 강력한 온라인 검증 로직이고 앱이 처음 시작된 후 TXLiveBase#setLicence를 호출할 때 네트워크 사용 가능한 상태여야 합니다. 앱이 처음 시작될 때 아직 네트워크 권한이 부여되지 않았을 수 있으므로, 네트워크 권한이 부여된 후 다시 TXLiveBase#setLicence를 호출해야 합니다.
TXLiveBase#setLicence 로드 결과의 모니터링: onLicenceLoaded 인터페이스가 실패 시 실제 상황에 따라 재시도 및 안내를 수행하고, 여러 번 실패한 경우 빈도 제한을 적용하고 제품 팝업 등의 안내를 통해 사용자가 네트워크 상태를 확인하도록 유도할 수 있습니다.
TXLiveBase#setLicence는 여러 번 호출할 수 있으며, App 메인 화면 진입 시 TXLiveBase#setLicence를 호출하여 로드가 성공적으로 완료되도록 하는 것이 좋습니다.
멀티 프로세스 앱의 경우, 플레이어를 사용하는 각 프로세스가 시작될 때 TXLiveBase#setLicence가 호출되도록 해야 합니다. 예를 들어,Android에서 독립 프로세스로 비디오를 재생하는 앱의 경우, 백그라운드 재생 중 프로세스가 시스템에 의해 종료되고 다시 시작될 때도 TXLiveBase#setLicence를 호출해야 합니다.
SDK가 점유한 모든 리소스가 릴리스된 후, SDK는 onExitRoom 콜백을 통해 알려줍니다.
enterRoom을 다시 호출하거나 다른 음성/영상 SDK로 전환하려면 onExitRoom 콜백이 발생한 후 관련 작업을 수행하십시오. 그렇지 않으면 카메라나 마이크 장치에서 점유됨 등 다양한 오류 문제가 발생할 수 있습니다.
2. 방 해산하기.
서버 측에서 방 해산합니다
RTC Engine은 서버 측에서 숫자 유형 방을 해산하는 API DismissRoom과 문자열 유형 방을 해산하는 API DismissRoomByStrRoomId를 제공합니다. 서버 측의 방 해산 인터페이스를 호출하여 방 내 모든 사용자를 방에서 나가게 시키고 방을 해산할 수 있습니다.
클라이언트 측에서 방 해산합니다
클라이언트에는 방을 직접 해산하는 API가 없으며, 각 클라이언트가 exitRoom을 호출하여 방을 나가야 합니다. 방 내 모든 스트리머와 시청자가 방을 나가면 RTC Engine 방 라이프사이클 규칙에 따라 방이 자동으로 해산됩니다. 자세한 내용은 RTC Engine 방 나가기을 참조하십시오.
주의:
라이브 방송이 종료된 후에는 서버 측의 방 해산 API를 호출하여 방을 해산시키는 것이 좋습니다. 이는 일부 사용자가 예정대로 방을 나가지 않아 방이 유지되고 예상치 못한 비용이 발생하는 것을 방지하기 위함입니다.
고급 기능
상품 정보의 팝업
상품 정보 팝업 기능은 Chat 자체 정의 메시지을 통해 구현할 수 있으며, SEI 정보을 통해서도 구현할 수 있습니다. 아래에서는 이 두 가지 구현 방식을 각각 소개하겠습니다.
자체 정의 메시지
자체 정의 메시지는 텐센트 클라우드Chat의 기능에 의존하며, 서비스를 사전에 개통하고 Chat SDK를 임포트해야 합니다. 자세한 안내는 음성 채팅방 접속 가이드-접속 준비을 참조하십시오.
1. 자체 정의 메시지의 전송.
방식 1: 스트리머가 클라이언트에서 상품 팝업과 관련된 그룹 커스텀 메시지를 전송합니다.
// 상품 팝업 메시지 본문의 구성
JSONObject jsonObject =newJSONObject();
try{
jsonObject.put("cmd","item_popup_msg");
JSONObject msgJsonObject =newJSONObject();
msgJsonObject.put("itemNumber",1);// 상품 번호
msgJsonObject.put("itemPrice",199.0);// 상품 가격
msgJsonObject.put("itemTitle","xxx");// 상품 제목
msgJsonObject.put("itemUrl","xxx");// 상품 이미지 주소
jsonObject.put("msg", msgJsonObject);
}catch(JSONException e){
e.printStackTrace();
}
String data = jsonObject.toString();
// 그룹 커스텀 메시지의 전송 (상품 팝업 메시지는 높은 우선순위로 설정하는 것이 좋음)
크로스 룸 PK 연결의 로컬 사용자와 상대 사용자는 모두 스트리머 역할이어야 하며, 오디오/비디오 업스트림이 모두 있어야 합니다.
ConnectOtherRoom()을 여러 번 호출하여 여러 방의 스트리머와 크로스 룸 연결을 구현할 수 있습니다. 현재에 한 방은 최대 세 개의 다른 방의 스트리머와의 크로스 룸 연결이 가능하며, 한 방 내에서 최대 10명의 스트리머가 다른 방의 스크리머와 크로스 룸 연결을 할 수 있습니다.
2. 두 방의 모든 사용자는 다른 방의 스크리머로부터 오디오/비디오 스트림 사용 가능 콜백을 받게 됩니다.
// SDK 내부 OpenGL 환경이 파기되었으며, 이때 제3자 뷰티 리소스 파기 작업을 진행할 수 있습니다.
mXmagicApi.onDestroy();
}
});
주의:
단계1 및 단계2는 제3자 뷰티 제품의 구현 방식에 따라 다르며, 단계3은 RTC Engine이 제3자 뷰티를 통합하는 공통적이고 중요한 단계입니다.
듀얼 인코딩 모드
듀얼 인코딩 모드를 활성화하면 현재 사용자의 인코더가 [고화질 대형 화면]과 [저화질 소형 화면] 두 가지 비디오 스트림을 동시에 출력합니다(단, 오디오 스트림은 하나만 존재함). 이렇게 하면 방의 다른 사용자가 자신의 네트워크 상황이나 화면 크기에 따라 [고화질 대형 화면] 또는 [저화질 소형 화면]을 선택하여 구독할 수 있습니다.
듀얼 스트림 인코딩 활성화 후, streamType 비디오 스트림 유형을 TRTC_VIDEO_STREAM_TYPE_SMALL으로 지정하여 저화질 소형 화면을 가져올 수 있습니다.
뷰 렌더링 컨트롤
RTC Engine에는 비디오 화면을 관리하는 인터페이스가 많으며, 이러한 인터페이스는 모두 비디오 렌더링 컨트롤을 지정해야 합니다. Android 플랫폼에서는 TXCloudVideoView를 비디오 렌더링 컨트롤로 사용하며, SurfaceView와 TextureView 두 가지 렌더링 방식을 지원합니다. 아래에서는 렌더링 컨트롤 유형을 지정하는 방법과 비디오 렌더링 컨트롤을 업데이트하는 방법을 소개합니다.
1. 특정 방식을 강제로 사용하거나 로컬 비디오 렌더링 컨트롤을 TXCloudVideoView으로 변환하려면 다음과 같이 코딩할 수 있습니다.
2. 입장및 퇴장 관련. 입장 실패 시 먼저 입장 매개변수가 올바른지 확인하고, 입장및 퇴장 인터페이스는 반드시 쌍으로 호출해야 합니다. 입장에 실패한 경우에도 퇴장 인터페이스를 호출해야 합니다.
열거형
값
설명
ERR_TRTC_CONNECT_SERVER_TIMEOUT
-3308
입장 요청이 시간 초과했습니다, 네트워크 연결이 끊겼는지 또는 VPN이 켜져 있는지 확인하세요. 4G로 전환하여 테스트할 수도 있습니다.
ERR_TRTC_INVALID_SDK_APPID
-3317
입장 매개변수 sdkAppId가 잘못되었습니다. TRTCParams.sdkAppId이 비어 있는지 확인하세요.
ERR_TRTC_INVALID_ROOM_ID
-3318
입장 매개변수 roomId가 잘못되었습니다. TRTCParams.roomId 또는 TRTCParams.strRoomId이 비어 있는지 확인하세요. roomId와 strRoomId는 혼용할 수 없습니다.
ERR_TRTC_INVALID_USER_ID
-3319
입장 매개변수 userId가 올바르지 않습니다. TRTCParams.userId이 비어 있는지 확인하세요.
ERR_TRTC_ENTER_ROOM_REFUSED
-3340
입장 요청이 거부되었습니다. enterRoom을 연속적으로 호출하여 동일한 ID의 방에 입장했는지 확인하세요.
3. 장치 관련. 장치 관련 오류를 감지할 수 있으며, 관련 오류 발생 시 UI에서 사용자에게 알립니다.
열거형
값
설명
ERR_CAMERA_START_FAIL
-1301
Windows 또는 Mac 장치에서 카메라 구성 프로그램(드라이버)이 비정상일 경우, 카메라 열 수가 없습니다. 장치를 비활성화한 후 다시 활성화하거나, 기기를 재시작하거나, 구성 프로그램을 업데이트하세요.
ERR_MIC_START_FAIL
-1302
Windows 또는 Mac 장치에서 마이크 구성 프로그램(드라이버)이 비정상일 경우, 마이크 열 수가 없습니다. 장치를 비활성화한 후 다시 활성화하거나, 기기를 재시작하거나, 구성 프로그램을 업데이트하세요.
ERR_CAMERA_NOT_AUTHORIZED
-1314
카메라 장치에 권한이 없습니다. 일반적으로 모바일 장치에서 발생하며, 사용자가 권한을 거부했을 수 있습니다.
ERR_MIC_NOT_AUTHORIZED
-1317
마이크 장치에 권한이 없습니다. 일반적으로 모바일 장치에서 발생하며, 사용자가 권한을 거부했을 수 있습니다.
ERR_CAMERA_OCCUPY
-1316
카메라가 사용 중입니다. 다른 카메라를 열어 볼 수 있습니다.
ERR_MIC_OCCUPY
-1319
마이크가 사용 중입니다. 예를 들어 모바일 장치에서 통화 중일 때 마이크를 열 수가 없습니다.
원격 미러 모드의 무효 문제
RTC Engine 설정 화면 미러는 로컬 미리보기 미러 setLocalRenderParams과 비디오 인코더 미러 setVideoEncoderMirror으로 나뉘며, 각각 로컬 미리보기 화면의 미러 효과와 비디오 인코딩 출력 화면의 미러 효과(원격 시청자 및 클라우드 레코딩의 미러링 모드)에 영향을 줍니다. 로컬 미리보기의 미러 효과가 원격 시청자 측에도 동시에 적용되도록 하려면 다음과 같이 코딩하십시오.