음성실 통합

﻿본 문서에서는 TUILiveKit 컴포넌트를 빠르게 통합하는 방법을 소개합니다. 이 문서를 따라 하시면 1시간 내에 다음 몇 가지 주요 단계들을 완료하고, 완벽한 UI 인터페이스를 갖춘 음성 채팅룸 기능을 최종적으로 얻을 수 있습니다..
앵커
시청자
﻿
﻿
﻿
﻿
﻿
﻿
환경 준비
Android 5.0(SDK API Level 21) 및 그 이상의 버전.
Gradle 7.0 및 그 이상의 버전.
Android 5.0 및 그 이상 버전의 스마트폰 장치.
단계 1: 서비스 활성화
Tencent Cloud에서 제공하는 오디오/비디오 서비스를 사용하기 전에 콘솔로 이동하여 애플리케이션에 대한 오디오/비디오 서비스를 활성화해야 합니다. 구체적인 절차는 서비스 활성화(TUILiveKit)을 참조하십시오.
단계 2: TUILiveKit 컴포넌트 다운로드
 Github에서 코드를 복제/다운로드한 후, Android 디렉토리 아래의 tuilivekit 하위 디렉토리를 현재 프로젝트의 app 동일 계층 디렉토리에 복사합니다, 아래 그림 참조:
﻿
단계 3: 프로젝트 구성
1. 프로젝트 루트 디렉토리의 settings.gradle.kts (또는 settings.gradle) 파일에 jitpack 레포지토리 주소, jitpack 의존성을 추가합니다(선물 svg 애니메이션을 재생하기 위한 타사 라이브러리 SVGAPlayer를 다운로드):
settings.gradle.kts
settings.gradle
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()

        // jitpack 레포지토리 주소 추가
        maven { url = uri("https://jitpack.io") }
    }
}
dependencyResolutionManagement {
        repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
        repositories {
                google()
                mavenCentral()
﻿
        // jitpack 레포지토리 주소 추가
        maven { url 'https://jitpack.io' }
    }
}
2. 프로젝트 루트 디렉토리의 settings.gradle.kts (또는 settings.gradle) 파일에 다음 코드를 추가하세요. 이 코드는 단계 2에서 다운로드한 tuilivekit 컴포넌트를 현재 프로젝트에 가져오는 데 사용됩니다:
settings.gradle.kts
settings.gradle
include(":tuilivekit")
include ':tuilivekit'
3. app 디렉토리에서 build.gradle.kts(또는 build.gradle) 파일을 찾아 다음 코드를 추가하세요. 이 코드는 현재 app에 새로 추가된 tuilivekit 컴포넌트에 대한 의존성을 선언하는 역할을 합니다:
build.gradle.kts
build.gradle
api(project(":tuilivekit"))
api project(':tuilivekit')
설명:
TUILiveKit 프로젝트 내부에는 TRTC SDK, IM SDK, tuiroomengine 및 공통 라이브러리 tuicore가 기본적으로 포함되어 있으며, 개발자가 별도로 구성할 필요가 없습니다. 버전 업그레이드가 필요하면 tuilivekit/build.gradle 파일을 수정하세요.
4. SDK 내부에서 Java의 리플렉션 기능을 사용하므로, SDK 내 일부 클래스를 난독화 목록에서 제외해야 합니다. proguard-rules.pro 파일에 다음 코드를 추가해 주세요:
-keep class com.tencent.** { *; }
5.  app 디렉토리에서 AndroidManifest.xml 파일을 찾아 application 노드에 tools:replace="android:allowBackup"을 추가하여 컴포넌트 내 설정을 덮어쓰고 자신의 설정을 사용합니다.
 // app/src/main/AndroidManifest.xml
  
  <application
    ...
  
    // 다음 설정을 추가하여 의존하는 SDK의 설정을 덮어쓰세요
    android:allowBackup="false"
    tools:replace="android:allowBackup">
단계 4: 로그인
프로젝트에 다음 코드를 추가하여 TUICore의 관련 인터페이스를 호출하여 TUI 컴포넌트의 로그인을 완료합니다. 이 단계는 매우 중요하며, 로그인에 성공해야만 TUILiveKit에서 제공하는 다양한 기능을 정상적으로 사용할 수 있습니다.
Kotlin
Java
// 로그인
TUILogin.login(applicationContext,
    1400000001,  // 단계 1에서 획득한 SDKAppID로 교체하세요
    "denny",  // 사용자의 UserID로 교체하세요
    "xxxxxxxxxxx",  // 콘솔에서 UserSig를 계산하여 이 위치에 입력할 수 있습니다
    object : TUICallback() {
        override fun onSuccess() {
            Log.i(TAG, "login success")
        }

        override fun onError(errorCode: Int, errorMessage: String) {
            Log.e(TAG, "login failed, errorCode: $errorCode msg:$errorMessage")
        }
    })
// 로그인
TUILogin.login(context, 
    1400000001,     // 단계 1에서 획득한 SDKAppID로 교체하세요
    "denny",        // 사용자의 UserID로 교체하세요
    "xxxxxxxxxxx",  // 콘솔에서 UserSig를 계산하여 이 위치에 입력할 수 있습니다
    new TUICallback() {
    @Override
    public void onSuccess() {
        Log.i(TAG, "login success");
    }
﻿
    @Override
    public void onError(int errorCode, String errorMessage) {
        Log.e(TAG, "login failed, errorCode: " + errorCode + " msg:" + errorMessage);
    }
});
매개변수 설명
여기서는 login 함수에 필요한 몇 가지 주요 매개변수에 대해 자세히 설명합니다:
매개변수
유형
설명
SDKAppID
int
단계 1의 마지막 단계에서 이미 획득한 정보입니다. 여기에서는 반복하여 설명하지 않겠습니다.
UserID
String
현재 사용자의 ID, 문자열 유형, 영문자(a-z 및 A-Z), 숫자(0-9), 하이픈 및 밑줄만 허용됩니다.
userSig
String
﻿단계 1의 세 번째 단계에서 획득한 SecretKey를 사용하여 SDKAppID, UserID 등의 정보를 암호화하면 UserSig를 획득할 수 있습니다. 이것은 Tencent Cloud가 현재 사용자의 TRTC 서비스 이용 가능 여부를 확인하기 위한 인증용 티켓입니다. 툴을 통해 임시로 사용할 수 있는 UserSig를 생성할 수 있습니다. 자세한 내용은 UserSig 계산 및 사용 방법을 참조하십시오.
설명:
개발 환경: 로컬 개발 및 디버깅 단계에서는 로컬 GenerateTestUserSig.genTestSig 함수를 사용하여 userSig를 생성할 수 있습니다. 이 방법에서는 SDKSecretKey가 쉽게 디컴파일을 통해 역방향으로 해독될 위험이 있습니다. 암호키가 유출되면 공격자는 당신의 Tencent Cloud 트래픽을 도용할 수 있습니다.
생산 환경: 프로젝트를 배포 및 출시하려면 서버 측 UserSig 생성 방법을 사용하십시오.
단계 5: 음성 채팅룸 생성
위의 로그인 메서드 호출이 성공적으로 반환된 후, VoiceRoomKit의 createRoom 메서드를 호출하여 음성 채팅룸을 생성하세요.
Kotlin
Java
import com.trtc.uikit.livekit.VoiceRoomKit;
﻿
VoiceRoomKit.createInstance(applicationContext).createRoom("roomId", VoiceRoomDefine.CreateRoomParams())
import com.trtc.uikit.livekit.VoiceRoomKit;
﻿
VoiceRoomKit.createInstance(getApplicationContext()).createRoom("roomId", new VoiceRoomDefine.CreateRoomParams());
음성 채팅룸 미리보기 화면
음성 채팅룸 룸 내 화면
﻿
﻿
﻿
﻿
﻿
﻿
단계 6: 음성 채팅룸 입장
위의 로그인 메서드 호출이 성공적으로 반환된 후, VoiceRoomKit의 enterRoom 메서드를 호출하여 룸 ID를 지정하고 음성 채팅 라이브룸에 입장합니다.
Kotlin
Java
import com.trtc.uikit.livekit.VoiceRoomKit;
﻿
VoiceRoomKit.createInstance(applicationContext).enterRoom("roomId")
import com.trtc.uikit.livekit.VoiceRoomKit;
﻿
VoiceRoomKit.createInstance(getApplicationContext()).enterRoom("roomId");
음성 채팅룸
음성 채팅룸
﻿
﻿
﻿
﻿
﻿
﻿
더 많은 기능
﻿룸 목록﻿
﻿앵커 팔로우﻿
﻿인터랙티브 댓글자막﻿
﻿인터랙티브 선물﻿
자주 묻는 질문
통합 및 사용 중 문제가 발생하면 자주 묻는 질문을 참조하세요.
교류 및 피드백
필요한 사항이나 피드백이 있으면 info_rtc@tencent.com으로 연락해 주세요.
매개변수	유형	설명
SDKAppID	int	단계 1의 마지막 단계에서 이미 획득한 정보입니다. 여기에서는 반복하여 설명하지 않겠습니다.
UserID	String	현재 사용자의 ID, 문자열 유형, 영문자(a-z 및 A-Z), 숫자(0-9), 하이픈 및 밑줄만 허용됩니다.
userSig	String	단계 1의 세 번째 단계에서 획득한 SecretKey를 사용하여 SDKAppID, UserID 등의 정보를 암호화하면 UserSig를 획득할 수 있습니다. 이것은 Tencent Cloud가 현재 사용자의 TRTC 서비스 이용 가능 여부를 확인하기 위한 인증용 티켓입니다. 툴을 통해 임시로 사용할 수 있는 UserSig를 생성할 수 있습니다. 자세한 내용은 UserSig 계산 및 사용 방법을 참조하십시오.
음성 채팅룸 미리보기 화면	음성 채팅룸 룸 내 화면