tencent cloud


Last updated: 2022-05-19 10:26:57

    This document describes how to quickly integrate the TRTC iOS SDK into your project.

    Environment Requirements

    • Xcode 9.0 or later
    • iPhone or iPad with iOS 9.0 or later
    • A valid developer signature for your project

    Integrating the TRTC SDK

    You can use CocoaPods to automatically load the SDK or download and import it manually into your project.


    1. Install CocoaPods

    Enter the following command in a terminal window (you need to install Ruby on your Mac first):

    sudo gem install cocoapods

    2. Create a Podfile

    Go to the directory of your project and enter the following command to create a Podfile in the directory.

    pod init

    3. Edit the Podfile

    Edit the Podfile and select an SDK edition based on your needs:

    • TRTC Lite: This edition has the smallest installation package, but integrates only TRTC and CDN playback (TXLivePlayer) features.

      platform :ios, '8.0'
      target 'App' do
      pod 'TXLiteAVSDK_TRTC', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_TRTC.podspec'
    • TRTC Professional:This edition integrates RTMP push (TXLivePusher), CDN playback (TXLivePlayer), VOD playback (TXVodPlayer), short video (UGSV), and other features.

      platform :ios, '8.0'
      target 'App' do
      pod 'TXLiteAVSDK_Professional', :podspec => 'https://liteav.sdk.qcloud.com/pod/liteavsdkspec/TXLiteAVSDK_Professional.podspec'

    You can use the official CocoaPods source, but the download may be slow:

      platform :ios, '8.0'
      source 'https://github.com/CocoaPods/Specs.git'
      target 'App' do
      pod 'TXLiteAVSDK_TRTC'

    4. Update the local repository and install the SDK

    Enter the following command in a terminal window to update the local repository and install the SDK:

    pod install

    Or, run this command to update the local repository:

    pod update

    An XCWORKSPACE project file integrated with the TRTC SDK will be generated. Double-click to open it.


    You need to manually add the dependent library Accelerate.framework.

    Manual integration

    1. Download the TRTC SDK and decompress the downloaded file.
    2. Open your Xcode project, select the target you want to run, and click Build Phases.
    3. Expand Link Binary With Libraries and click the + icon at the bottom to add dependent libraries.
    4. Add the downloaded TRTC SDK framework and the libraries it depends on: VideoToolBox.framework, MetalKit.framework, SystemConfiguration.framework, ReplayKit.framework, libc++.tbd, Accelerate.framework, CoreMedia.framework, and CoreTelephoney.framework.
    5. If you use TRTC SDK v9.6 or a later version, you need to manually add the dynamic libraries.
      Click General, expand Frameworks, Libraries, and Embedded Content, and click the + icon at the bottom to add the dynamic libraries required by TXLiteAVSDK_TRTC.framework: TXFFmpeg.xcframework and TXSoundTouch.xcframework. Click Embed & Sign.

    Granting Camera and Mic Permissions

    To use the audio/video features of the SDK, you need to grant it mic and camera permissions. Add the two items below to Info.plist of your application. Their content is what users see in the mic and camera access pop-up windows.

    • Privacy - Microphone Usage Description, plus a statement specifying why mic access is needed
    • Privacy - Camera Usage Description, plus a statement specifying why camera access is needed

    Importing the TRTC SDK

    You can import the TRTC SDK in two ways.

    Method 1: Using Objective-C or Swift APIs

    There are two ways to use the SDK in Objective-C or Swift:

    • Import the module: Import the SDK module in the files that will use the SDK APIs.

      @import TXLiteAVSDK_TRTC;
    • Import the header file: Import the header file in the files that will use the SDK APIs.

      #import TXLiteAVSDK_TRTC/TRTCCloud.h

    Method 2: Using C++ APIs

    1. Import the header file: If you want to use C++ APIs to develop your iOS application, import the header file in the TXLiteAVSDK_TRTC.framework/Headers/cpp_interface directory.

      #include TXLiteAVSDK_TRTC/cpp_interface/ITRTCCloud.h
    2. Use the namespace: The cross-platform C++ methods and types are all defined in the TRTC namespace, which you can use directly. This method can simplify your code and is recommended.

      using namespace trtc;

    For more information on how to use C++ APIs, see Overview.


    Can the SDK run in the background?

    Yes. If you want the SDK to run in the background, select your project, under the Capabilities tab, toggle on Background Modes, and select Audio, AirPlay, and Picture in Picture.

    Contact Us

    Contact our sales team or business advisors to help your business.

    Technical Support

    Open a ticket if you're looking for further assistance. Our Ticket is 7x24 avaliable.

    7x24 Phone Support