tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집
문서Tencent Real-Time CommunicationCall오프라인 푸시Android

Android

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2024-07-23 17:41:08
오프라인 푸시 기능을 사용하면 애플리케이션이 ‘백그라운드에서 실행’되거나 ‘오프라인 상태’에도 오디오/비디오 통화를 수신할 수 있습니다. TUICallKit은 TUIOfflinePush 컴포넌트를 통합하여 오프라인 푸시 기능을 구현합니다. 이 문서는 음성/영상 통화 프로젝트에 TUIOfflinePush 컴포넌트를 통합하는 방법을 설명합니다.

준비 사항

1. 벤더의 푸시 플랫폼에 애플리케이션을 등록합니다. 오프라인 푸시 기능은 벤더의 자체 채널에 의존합니다. APPID 및 APPKEY와 같은 매개변수를 가져오려면 벤더의 푸시 플랫폼에 애플리케이션을 등록해야 합니다.
주의사항：
다음 두 파일은 이후 단계에서 사용됩니다.
Huawei Push에 등록할 때 agconnect-services.json 파일을 다운로드하여 저장합니다.
Google FCM에 등록할 때 google-services.json 파일을 다운로드하여 저장합니다.
Google FCM

img


2. IM 콘솔에서 구성
메시지 연동을 위해 각 벤더 채널에 등록할 때 동일한 패키지 이름을 입력해야 합니다. 생성된 ID APPID, APPKEY를 기록해 두십시오. 이는 이후 단계에서 사용됩니다.

1단계: 컴포넌트 다운로드 및 가져오기

1. Github로 이동하여 코드를 복제/다운로드한 다음 아래와 같이 Android 디렉터리의 tuiofflinepush 서브 디렉터리를 프로젝트의 app과 동일한 디렉터리에 복사합니다.

img


2. 프로젝트 루트 디렉터리에서 setting.gradle 파일을 찾아 다음 코드를 추가합니다.
include ':tuiofflinepush'
3. app 디렉터리에서 'build.gradle' 파일을 찾아 다음 코드를 추가하여 방금 추가한 tuiofflinepush 컴포넌트에 대한 현재 app의 종속성을 선언합니다.
api project(':tuiofflinepush')

2단계: 프로젝트 구성

1. app 디렉터리에서 build.gradle 파일을 찾아 필요에 따라 애플리케이션 패키지의 이름을 바꿉니다.
applicationId 'com.****.trtc'
2. app 디렉터리에서 build.gradle 파일을 찾아 ViVo 액세스 매개변수 VIVO_APPKEY, VIVO_APPID 및 HONOR_APPID를 설정하여 컴파일 또는 실행 오류를 방지합니다.
manifestPlaceholders = [
    "VIVO_APPKEY": "PLACEHOLDER", 
    "VIVO_APPID" : "PLACEHOLDER",
    "HONOR_APPID": "PLACEHOLDER"
]
3. Huawei 및 Google 푸시 플랫폼용 파일 구성: app 디렉터리에 준비 과정에서 Google FCM에 등록할 때 저장한 google-services.json 파일을 교체합니다. app 디렉터리에 준비 과정에서 Huawei Push에 등록할 때 저장한 agconnect-services.json 파일을 추가합니다.
4. PrivateConstants 파일에 준비 과정에서 기록된 ID, APPID, APPKEY를 입력하고 매개변수 설정이 올바른지 확인합니다. 다음 매개변수를 입력합니다.
public class PrivateConstants {
    /****** Xiaomi 오프라인 푸시 매개변수 start ******/
    // Tencent Cloud 콘솔에서 타사 푸시 인증서를 업로드한 후 생성된 인증서 ID
    public static final long XM_PUSH_BUZID = 애플리케이션에 할당된 인증서의 ID;
    // Xiaomi 개방형 플랫폼에서 할당한 APPID 및 APPKEY
    public static final String XM_PUSH_APPID = "애플리케이션에 할당된 인증서의 APPID";
    public static final String XM_PUSH_APPKEY = "애플리케이션에 할당된 인증서의 APPKEY";
    /****** Xiaomi 오프라인 푸시 매개변수 end ******/
}
주의사항：
이 단계는 매우 중요합니다. 매개변수 구성이 올바른지 주의 깊게 확인하십시오.
상기 단계를 완료하면 프로젝트에서 TUICallKit의 오프라인 깨우기 기능을 사용할 수 있습니다.

3단계: 오프라인 알림 콘텐츠 사용자 지정

TUICallKit은 기본 알림 형식을 제공합니다. 단, 알림 내용을 사용자 지정 하려면 OfflinePushInfoConfig.java 파일을 수정하십시오.
public static TUIOfflinePushInfo createOfflinePushInfo(Context context) {    
    TUIOfflinePushInfo pushInfo = new TUIOfflinePushInfo();    
    pushInfo.setTitle("mike");    
    pushInfo.setDesc("You have receive a new call");    
    // OPPO는 ChannelID를 설정해야 푸시 메시지를 수신할 수 있으며, 이 channelID는 콘솔과 일치해야 함    
    // OPPO must set a ChannelID to receive push messages. This channelID needs to be the same as the console.    
    pushInfo.setAndroidOPPOChannelID("tuikit");    
    pushInfo.setIgnoreIOSBadge(false);    
    pushInfo.setIOSSound("phone_ringing.mp3");  
    return pushInfo;
}

FAQ

사용자가 오프라인 푸시 알림을 수신할 수 없는 경우 문제 해결을 위해 문의하기 하십시오.

1. 알림이 수신되지 않으면 어떻게 해야 하나요?

벤더 콘솔에서 푸시 서비스를 테스트합니다. 알림을 성공적으로 푸시할 수 있으면 벤더 채널이 정상입니다. 그런 다음 TUIOfflinePush 콘솔에서 벤더 매개변수가 올바르게 구성되었는지 확인하고, 그렇지 않은 경우 필요에 따라 매개변수를 입력합니다(테스트한 대로, 콘솔에서 vivo x9용 메시지 유형을 구성해야 합니다).
일부 휴대폰은 '중요하지 않은 알림' 폴더로 알림을 보냅니다. 이 경우 상태 표시줄을 아래로 드래그하여 알림이 '중요하지 않은 알림' 폴더에 있는지 확인하십시오.
다음 로그를 필터링하여 TUIOfflinePush가 성공적으로 등록되었는지 확인합니다.
TUIOfflinePush

2. 알림을 받았을 때 잠금 화면이 켜지지 않는 이유는 무엇입니까?

벤더 및 플랫폼에 의해 부과된 제한으로 인해 Android 휴대폰은 화면이 잠겨 있을 때 다른 권한이 필요합니다. 다음과 같이 문제를 해결하십시오.
시스템 잠금 화면 알림 권한이 활성화되어 있는지 확인하십시오. 일부 벤더에서는 통합 제한을 적용했습니다. 예를 들어 오프라인 알림을 수신할 때 Xiaomi 휴대폰의 화면이 켜지지 않으면 설정 > 잠금 화면을 선택하고 알림을 위해 잠금 화면 깨우기를 켭니다.
애플리케이션의 잠금 화면 알림 권한이 활성화되어 있는지 확인합니다. 예를 들어 Xiaomi 휴대폰에서 잠금 화면 알림 허용을 토글해야 합니다.
설명：
이 문제에 대한 호환성 처리가 필요한 경우 지원을 위해 당사(QQ 그룹 592465424)에 문의하십시오.

3. 오프라인 푸시 알림을 클릭하면 통화 UI를 가져올 수 없는 이유는 무엇인가요?

다음 로그를 필터링하여 통화 요청이 감지되었는지 확인합니다.
onReceiveNewInvitation

4. 애플리케이션이 백그라운드에서 실행 중일 때 호출 UI를 포그라운드로 가져올 수 없는 이유는 무엇입니까?

애플리케이션을 백그라운드에서 포그라운드로 자동으로 끌어오기 위해서는 App에서 ‘백그라운드 자동 시작’ 또는 ‘플로팅 창’ 권한이 활성화되어 있는지 확인해야 합니다.
다른 벤더 또는 동일한 벤더의 다른 Android 버전이라도 다른 권한 및 권한 이름을 제공합니다. 예를 들어, Xiaomi 6에 대한 백그라운드 팝업 창 권한만 활성화하면 되고 백그라운드 팝업 창 및 플로팅 창 표시 권한을 모두 활성화해야 합니다.
설명：
테스트 중에 모든 권한을 수동으로 활성화하면 여전히 호출 UI를 자동으로 포그라운드로 가져올 수 없으며 호환성 처리가 필요합니다.
이전 주제: VoIP（Apple LiveCommunicationKit）다음 주제: Notification

도움말 및 지원

문제 해결에 도움이 되었나요?

피드백