Tencent Real-Time Communication Tencent Real-Time Communication FAQs Product Documentation ©2013-2019 Tencent Cloud. All rights reserved. Page 1 of 50 Tencent Real-Time Communication Copyright Notice ©2013-2019 Tencent Cloud. All rights reserved. Copyright in this document is exclusively owned by Tencent Cloud. You must not reproduce, modify, copy or distribute in any way, in whole or in part, the contents of this document without Tencent Cloud's the prior written consent. Trademark Notice All trademarks associated with Tencent Cloud and its services are owned by Tencent Cloud Computing (Beijing) Company Limited and its affiliated companies. Trademarks of third parties referred to in this document are owned by their respective proprietors. Service Statement This document is intended to provide users with general information about Tencent Cloud's products and services only and does not form part of Tencent Cloud's terms and conditions. Tencent Cloud's products or services are subject to change. Specific products and services and the standards applicable to them are exclusively provided for in Tencent Cloud's applicable terms and conditions. ©2013-2019 Tencent Cloud. All rights reserved. Page 2 of 50 Tencent Real-Time Communication Contents FAQs How to Deal with Firewall Restrictions iLiveSDK Upgrade How to Downsize Installation Package UserSig Features Android and iOS Desktop Browser Flutter Other ©2013-2019 Tencent Cloud. All rights reserved. Page 3 of 50 Tencent Real-Time Communication FAQs How to Deal with Firewall Restrictions Last updated：2021-06-09 18:09:35 Some customers have restrictions placed on public network access by their own companies, so they need to be added to a firewall allowlist before they can get access. The following describes the related rules: What ports or domain names do I need to add to the allowlist of native SDK for client? The firewall ports are as follows: TRTC SDK (Native) Allowed Items TCP port 443; 20166 UDP port 8000、8080、16285、9000 Domain name allowlist: cloud.tim.qq.com gz.file.myqcloud.com avc.qcloud.com yun.tim.qq.com dldir1.qq.com mlvbdc.live.qcloud.com query.tencent-cloud.com What ports or domain names do I need to add to the allowlist of WebRTC? The firewall ports are as follows: WebRTC (H5) Allowed Items TCP port 8687 UDP port 8000; 8800; 843; 443 Domain name allowlist: ©2013-2019 Tencent Cloud. All rights reserved. Page 4 of 50 Tencent Real-Time Communication qcloud.rtc.qq.com What domain names do I need to add to the allowlist of WeChat Mini Program? <trtc-room> domain name allowlist: https://official.opensso.tencent-cloud.com https://yun.tim.qq.com https://cloud.tencent.com https://webim.tim.qq.com https://query.tencent-cloud.com Tencent Cloud server IP addresses are dynamically updated, with no fixed batch of IP addresses, so we cannot provide you with a list of fixed IPs. ©2013-2019 Tencent Cloud. All rights reserved. Page 5 of 50 Tencent Real-Time Communication iLiveSDK Upgrade Last updated：2021-08-25 16:52:53 What are the differences between TRTC V1 (iLiveSDK) and V2 (LiteAVSDK)? Item Old (V1) New (V2) Architecture iLiveSDK LiteAVSDK IM SDK Built-in Not built-in API V1 V2 CDN streaming Must be enabled via RESTful API Can be enabled via client Line V1 V2 How do I upgrade from TRTC V1 (iLiveSDK) to V2 (LiteAVSDK)? If your project has never integrated the TRTC SDK, we strongly recommend that you use V2 (LiteAVSDK) from the beginning, which outperforms V1 in terms of call quality, line, ease of integration, and feature extension. ©2013-2019 Tencent Cloud. All rights reserved. Page 6 of 50 Tencent Real-Time Communication If your project is running stably without encountering any problems, we recommend that you stick to V1 for the time being as the lines of V1 and V2 are not interconnected currently. If you are in the process of integrating the old version SDK (V1) into your project, we recommend that you switch to V2, which uses brand new APIs and is much faster to integrate than V1. If you are already using V1 and hope to improve your call quality by upgrading to V2, since the lines of V1 and V2 are not interconnected currently, you need to first integrate the new SDK into your project, wait for the new version to cover your user base, and then switch from V1 to V2 lines in the cloud. See below for details: i. Integrate the new SDK into your project and run a test. ii. Add a field that indicates the SDK version number in the room list so that your application can determine whether to use the V1 or V2 SDK based on this field on the server. iii. Release the update to your application and wait for it to cover your user base. iv. Change the field indicating the SDK version number in the room list from V1 to V2 to switch from V1 to V2 lines. How do I integrate LiteAVSDK and iLiveSDK for Android at the same time? Both iLiveSDK and LiteAVSDK use Tencent Real-time Audio Engine (TRAE) to process audio, for example, for noise suppression and echo cancellation. LiteAVSDK uses a newer version of TRAE and includes all the APIs of iLiveSDK. Therefore, you only need to configure the TRAE library of LiteAVSDK for your project. Integrate the SDKs as AAR files and, in the build.gradle file of your subproject (the application directory), add code in the android{} closure as described below. Note： You must reference LiteAVSDK before iLiveSDK. android{ // 1. Configure packaging options in Gradle packagingOptions { pickFirst 'lib/armeabi-v7a/libTRAECodec.so' pickFirst 'lib/armeabi-v7a/libstlport_shared.so' pickFirst 'lib/armeabi/libTRAECodec.so' pickFirst 'lib/armeabi/libstlport_shared.so' } // 2. Import dependencies implementation(name:'LiteAVSDK_TRTC_6.4.7108', ext:'aar') // Make sure that you import LiteAVSDK before iLiveSDK ©2013-2019 Tencent Cloud. All rights reserved. Page 7 of 50 Tencent Real-Time Communication implementation 'com.tencent.ilivesdk:ilivesdk:1.9.4.6.4' } How do I integrate LiteAVSDK, iLiveSDK, and BeautySDK for iOS at the same time? TRTC V1 uses BeautySDK to implement features including beauty filters and animated effects. These features are built into TRTC V2. As a result, if your project has already integrated iLiveSDK and imported BeautySDK, a file conflict will occur. Below is the solution: Edition Solution BeautySDK Basic Add a header search path for BeautySDK in your Xcode project and unlink (without BeautySDK. retouching features) BeautySDK Use LiteAVSDK Enterprise, add a header search path for BeautySDK in your Advanced Xcode project, and unlink BeautySDK (LiteAVSDK Enterprise integrates the (with retouching component, which you can use with the license you have already retouching purchased.) features) How do I integrate LiteAVSDK and iLiveSDK for Windows at the same time? Both iLiveSDK and LiteAVSDK for Windows use Tencent Real-time Audio Engine (TRAE) to process audio, for example, for noise suppression and echo cancellation. However, LiteAVSDK uses a newer version of TRAE and differs from iLiveSDK in terms of feature usage. Therefore, you cannot use it to replace the TRAE of iLiveSDK directly. Below is the solution: Project structure We recommend the following project structure: | |- Main application.exe |- Other files main application.exe depends on |- iLiveSDK.dll |- Other files iLiveSDK.dll depends on |- LiteAV | |- liteav.dll | |- Other files liteav.dll depends on ©2013-2019 Tencent Cloud. All rights reserved. Page 8 of 50 Tencent Real-Time Communication Initialization You can use iLiveSDK by linking a LIB file into your project or load it dynamically using the code below: HMODULE hiLive = LoadLibrary("iLiveSDK.dll"); To use LiteAVSDK, load and initialize it using the code below: typedef ITRTCCloud* (*getTRTCShareInstanceMtd)(); typedef void(*destroyTRTCShareInstanceMtd)(); TCHAR dllPath[MAX_PATH]; GetModuleFileName(nullptr, dllPath, MAX_PATH); PathRemoveFileSpec(dllPath); wcscat(dllPath, L"\\LiteAV\\"); SetDllDirectory(dllPath); HMODULE hLiteAV = LoadLibrary(L"liteav.dll"); if (!hLiteAV) { printf("Failed to load liteav.dll: %d", GetLastError()); return; } getTRTCShareInstanceMtd pGetTRTCShareInstance = (getTRTCShareInstanceMtd)GetProcAddress(hLiteAV, "getTRTCShareInstance"); if (!pGetTRTCShareInstance) { printf("Failed to load the getTRTCShareInstance function"); return; } destroyTRTCShareInstanceMtd pDestroyTRTCShareInstance = (destroyTRTCShareInstanceMtd)GetProcAddre ss(hLiteAV, "destroyTRTCShareInstance"); if (!pDestroyTRTCShareInstance) { printf("Failed to load the destroyTRTCShareInstance function"); return; } ITRTCCloud *pTrtcCloud = m_pGetTRTCShareInstance(); if (!pTrtcCloud) { printf("Failed to create a TRTC instance"); return; } SetDllDirectory(nullptr); pTrtcCloud->enterRoom(...); ©2013-2019 Tencent Cloud. All rights reserved. Page 9 of 50 Tencent Real-Time Communication How to Downsize Installation Package Last updated：2021-01-14 17:09:54 How much will the file increment be after the TRTC SDK is integrated? The file size increment varies by TRTC SDK version. For more information, please see SDK Download. How do I reduce the size of an installation package for iOS? Method 1. Only package the ARM64 architecture (recommended) For iPhone models after 5s, you can just package x64 architecture by setting "Build Active Architecture Only" in "Build Settings" in Xcode to "Yes" and write only arm64 into "Valid Architectures". The single-architecture IPA increment of the TRTC SDK will be 1.9 MB only. Method 2. Enable Bitcode For iPhone 5s and older models, if all third-party libraries in the project support Bitcode, you can enable Bitcode to reduce the size of the installation package. Toggle on "Enable Bitcode" in "Build Settings" > "Build Options" to enable bitcode. From 2016 on, Apple started to support Bitcode compilation in the Xcode development environment. After Bitcode is enabled, the compiler will generate the application's intermediate ©2013-2019 Tencent Cloud. All rights reserved. Page 10 of 50 Tencent Real-Time Communication code instead of the actual assembly code, and users will download and install the machine code generated for the specific mobile CPU architecture from App Store, which greatly reduces the installation package size. How do I reduce the size of an installation package for Android? Method 1.