tencent cloud

Feedback

Function Configuration

Last updated: 2022-06-28 17:13:47

    After creating an application, you can enable relay to CDN, on-cloud recording, and advanced permission control for the application in Function Configuration. The configuration takes effect in about 5 minutes.

    Relay to CDN

    Notes

    • Relay to CDN is the process of TRTC converting UDP-based audio/video streams and pushing them to the CSS system.
    • Relay to CDN is disabled by default. To enable it, you need to activate CSS first.
    • Using the relay to CDN feature to implement CDN relayed live streaming incurs fees from CSS based on the amount of downstream traffic or bandwidth used. For details, see Bill-by-Traffic/Bandwidth.
    • Using the relay to CDN feature to implement on-cloud recording will incur recording and storage fees.
    • If you have bound recording, transcoding, screencapturing & porn detection, or watermarking templates to a relay address (xxxx.livepush.myqcloud.com) in the CSS console, you will be charged additional fees.

    Enabling relay to CDN

    1. Log in to the TRTC console and select Application Management on the left sidebar.
    2. Click Function Configuration for the application whose configuration you want to modify.
    3. In the Relay to CDN area, toggle on Enable relay to CDN.
    4. In the dialog box that pops up, read the risk statement carefully. If you are sure you want to enable the feature, select the box and click Enable relay to CDN.

    Choosing the relay mode

    After enabling relay to CDN, you can choose the relay mode that fits your needs.

    • Specified-stream relay: After selecting this mode, if you do not need the On-Cloud MixTranscoding service, call the client-side SDK API startPublishing to start relayed push; if you need the service, do as instructed in the "On-Cloud MixTranscoding" document to start relay automatically after On-Cloud MixTranscoding.
    • Global relay: After you select this mode, all upstream audio/video streams of TRTC are automatically pushed to the CSS system.

    Disabling relay to CDN

    To disable relayed push, follow these steps:

    1. Select Application Management on the left sidebar, and click Function Configuration for the application whose configuration you want to modify.
    2. In the Relay to CDN area, toggle off Enable relay to CDN.
    3. In the dialog box that pops up, read the risk statement carefully; if you are sure you want to disable the feature, click Disable relay to CDN.

    On-Cloud Recording

    Notes

    • On-cloud recording relies on the relay to CDN feature and leverages the capabilities of CSS. Recording files are saved in VOD.
    • The recording feature is provided by CSS and is charged according to the peak number of concurrent recording channels during each month. For details, see CSS > CSS Recording Billing.
    • Recording files are stored in VOD, and fees are based on the amount of storage space used. For details, see VOD > Pay-as-You-Go.
    • If you play or download a recording file, a traffic (video acceleration) fee is charged based on the amount of downstream traffic accelerated. For details, see VOD > Pay-as-You-Go.
    • On-cloud recording is disabled by default. To enable the feature, you need to activate CSS and VOD first.
    • To enable on-cloud recording, you need to enable relay to CDN first.

    Enabling on-cloud recording

    The on-cloud recording feature of TRTC allows you to record the audio/video streams of each user as separate files. T

    Modifying on-cloud recording configuration

    Note:

    Modifying the on-cloud recording configuration may affect your active business. Make sure you understand the risks before the modification.

    1. Select Application Management on the left sidebar, and click Function Configuration for the application whose configuration you want to modify.
    2. In On-Cloud Recording Configuration, click Edit to go to the edit page.
    3. Modify the configuration information as needed, and click Confirm to save the modification.

    Disabling on-cloud recording

    After you disable on-cloud recording, you will not be able to manually or automatically record streams on the cloud. Please make sure you no longer need the feature before disabling it.

    1. Select Application Management on the left sidebar, and click Function Configuration for the application whose configuration you want to modify.
    2. In the On-Cloud Recording Configuration area, toggle on Enable On-Cloud Recording.
    3. If you are sure about disabling the feature after reading the risks, click Disable On-Cloud Recording.

    Advanced Permission Control

    Advanced permission control lets you control which users have permission to enter rooms and turn on their mic without needing to configure permissions on the client, which helps to keep the service protected against attacks and cracking.

    Notes

    After you enable advanced permission control for an application (SDKAppID), all users using the application must pass the correct privateMapKey in TRTCParams to enter a room. Therefore, you are not advised to enable the feature for an application if you have users using it.

    Enabling advanced permission control

    1. Select Application Management on the left sidebar and click Function Configuration for the application for which you want to enable advanced permission control.
    2. In the Advanced Permission Control area, toggle on Enable.

    Disabling advanced permission control

    1. Select Application Management on the left sidebar and click Function Configuration for the application for which you want to disable advanced permission control.
    2. In the Advanced Permission Control area, toggle off Enable.

    Relevant Documentation

    • To create an application, see Creating an Application.
    • To search for an application in the application list, see Searching for Applications.
    • To view the basic information of an application, see Application Info.
    • If you want to set an image as the background displayed during on-cloud stream mixing, you can add the image in Material Management.
    • To get the demo source code to help you get started quickly, see Quick Start.
    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