tencent cloud

Feedback

Last updated: 2024-03-26 11:20:22
    This document describes how to quickly run the demo for the TRTC Web SDK.

    Prerequisites

    Steps To Run Demo

    Step 1. Create an application

    1. Log in to the TRTC console overview page, click Create Application.
    2. In the popup page, select RTC Engine, enter the application name, and then click Create.
    
    

    Step 2. Get your SDKAppId and SDKSecretKey

    After your application created, you can get your SDKAppID and SDKSecretKey in Basic informaction, which are used to run demo.
    
    
    

    Step 3. Run demo

    1. Run demo online.
    We provides the following basic demos. You can choose the project framework you are familiar with to run and experience:
    1.1 quick-demo-js is a demo coded by Javascript. Souce code: github.
    1.2 quick-demo-vue2-js is a demo coded by Vue2 + Javascript. Source code: github.
    1.3 quick-demo-vue3-ts is a demo coded by Vue3 + Typescript. Source code: github.
    2. Run demo locally.
    2.1 Download source code by Github or Zip.
    2.2 Run demo locally by following steps.
    quick-demo-js
    quick-demo-vue2-js
    quick-demo-vue3-ts
    1. Find and open TRTC_Web/quick-demo-js/index.html file in the downloaded source code.
    2. Fill in the SDKAppId and SDKSecretKey obtained in Step2
    
    
    
    3. Function Experience:
    Click the Enter Room button to enter the room.
    Click the Start Local Audio/Video button to capture microphone or camera.
    Click the Stop Local Audio/Video button to stop capturing microphone or camera.
    Click the Start Share Screen button to start screen sharing.
    Click the Stop Share Screen button to cancel screen sharing.
    4. After entering the room, you can invite others to experience the TRTC Web voice and video communication function together through the sharing invitation link.
    1. Find and go to the directory TRTC_Web/quick-demo-vue2-js/ in the downloaded source code.
    cd quick-demo-vue2-js
    2. Run the demo locally by executing the following command in the terminal, which will automatically install dependencies and run the demo.
    You may need to install Nodejs first.
    npm start
    3. The default browser will automatically open the address http://localhost:8080/.
    4. Fill in the SDKAppId and SDKSecretKey obtained in Step2.
    
    
    
    5. Experience
    Input userId and roomId
    Click the Enter Room button to enter the room
    Click the Start Local Audio/Video button to capture microphone or camera
    Click the Stop Local Audio/Video button to stop capturing microphone or camera
    Click the Start Share Screen button to start screen sharing
    Click the Stop Share Screen button to stop screen sharing
    6. After entering the room, you can invite others to experience TRTC's web-based audio and video communication feature by sharing the invitation link.
    1. Find and go to the directory TRTC_Web/quick-demo-vue3-ts/ in the downloaded source code.
    2. Run the demo locally by executing the following command in the terminal, which will automatically install dependencies and run the demo.
    You may need to install Nodejs first.
    npm start
    3. The default browser will automatically open the address http://localhost:3000/.
    4. Fill in the SDKAppId and SDKSecretKey obtained in Step2.
    
    
    
    5. Experience
    Input userId and roomId
    Click the Enter Room button to enter the room
    Click the Start Local Audio/Video button to capture microphone or camera
    Click the Stop Local Audio/Video button to stop capturing microphone or camera
    Click the Start Share Screen button to start screen sharing
    Click the Stop Share Screen button to stop screen sharing
    6. After entering the room, you can invite others to experience TRTC's web-based audio and video communication feature by sharing the invitation link.
    Note
    In the demo above, we used SDKSecretKey to generate UserSig locally in order to make it easier for you to run demo quickly. In your production environment, you cannot generate userSig in this way, because SDKSecretKey leakage may cause attackers to steal your TRTC traffic.
    The correct way to generate UserSig is to integrate Server-Side Generation of UserSig on your server. When an user enters the room:
    Send a http request to your server.
    Generate a UserSig on your server.
    Return it to the user to enter the room.
    When you deploy your page to a production environment, you need to have your page accessed through the HTTPS(e.g. https://domain/xxx). For the reason, please refer to the document Page Access Protocol Restriction Description.

    Start Integration

    Refer to SDK Quickstart.

    FAQs

    Supported platforms

    TRTC Web SDK is based on WebRTC implementation and currently supports desktop and mobile major browsers(Chrome, Edge, Safari, Firefox, Opera). For details about the browsers supported, see Supported Platforms.

    URL protocol support

    Because of the security policies of browsers, when you use WebRTC, there are requirements on the protocol used for access. For details, see the table below.
    Scenario
    Protocol
    Receive (Playback)
    Send (Publish)
    Share Screen
    Remarks
    Production
    HTTPS
    Yes
    Yes
    Yes
    Recommended
    Production
    HTTP
    Yes
    No
    No
    -
    Local development
    http://localhost
    Yes
    Yes
    Yes
    Recommended
    Local development
    http://127.0.0.1
    Yes
    Yes
    Yes
    -
    Local development
    http://[local IP address]
    Yes
    No
    No
    -
    Local development
    file:///
    Yes
    Yes
    Yes
    -

    Firewall configuration

    Others

    For more, see: Web FAQs.
    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