tencent cloud

Feedback

Integrating TUIRoom (Windows and macOS)

Last updated: 2024-09-14 16:38:21
    This document describes the TUIRoom component for PC, an audio/video communication and collaboration tool with flexible layout and high adaptability. It can be used in various scenarios such as online collaboration, remote recruitment, remote diagnosis, insurance claim, online customer service, video interview, digital government services, finance digitization, online conferencing, and online education. It is integrated in depth with many industrial scenarios to help enterprises reduce costs, improve efficiency, and promote digitization for higher competitiveness. You can download and install the application for Windows or macOS to try out the component.
    Note
    All TUIKit components are based on Tencent Cloud's TRTC and Chat services. When you activate TRTC, Chat and the trial edition of the Chat SDK (which supports up to 100 DAUs) will also be activated automatically. For Chat billing details, see Pricing.

    Demo UI

    
    
    
    

    Solution Strengths

    TUIRoom integrates various capabilities such as ultra-low-latency audio/video call, chat room, screen sharing, beauty filter, device detection, and statistics, covering the common features of group audio/video room.
    It can be further developed as needed to quickly implement custom UI and layout, helping you quickly launch your business.
    It encapsulates the basic TRTC and Chat SDKs to implement basic logic control and provides APIs for you to call features easily.

    Connection Guide

    Two connection methods are recommended to help you quickly connect to the group audio/video room feature. You can select an appropriate method for secondary development.

    Preparing the environment

    Windows environment :
    Integrated development environment: Visual Studio 2015 or later.
    Qt 5.9.1 or later.
    Qt Visual Studio Tools 2.2.0 or later.
    Operating system: Windows 8 or later.
    Make sure that you can develop the project normally in the integrated development environment.
    macOS environment:
    Qt 5.9.1 or later.
    QtCreator integrated development environment. To use QtCreator, select it when installing Qt, and its version is the same as that of the Qt official installation package.
    Make sure that you can develop the project normally in the QtCreator integrated development environment.

    Starting via external process

    1. Compile the RoomApp program.
    The method of using an external process to start RoomApp depends on the executable program of the original RoomApp, which needs to be compiled in advance.
    Go to RoomApp, clone the source code, and configure the project to compile and generate RoomApp.
    2. Create the TestApp project.
    Windows
    macOS
    1. Open Visual Studio, select the Qt Widgets Application project type, and create the TestApp project.
    
    
    2. Write the process starting program and call the LoadRoomApp function at an appropriate position.
    #include <QProcess>
    #include <QApplication>
    void LoadRoomApp() {
    QString executable_file_path = QApplication::applicationDirPath();
    QString app_path = executable_file_path + "/RoomApp.exe";
    QProcess::startDetached(app_path);
    }
    
    
    3. Compile the project and copy the RoomApp compilation result to the directory of the current executable program. Here, a release x86 program is taken as an example: Copy all files in the TUIRoom\\Windows-Mac\\RoomApp\\bin\\Win32\\Release directory to the current program directory.
    4. Run the program to start TestApp and RoomApp at the same time.
    1. Open QtCreator, select the Qt Widgets Application project, and create the TestApp project.
    
    
    2. Write the process starting program and call the LoadRoomApp function at an appropriate position.
    #include <QProcess>
    #include <QApplication>
    void LoadRoomApp() {
    QString executable_file_path = QApplication::applicationDirPath();
    QString app_path = executable_file_path + "/../../../RoomApp.app/Contents/MacOS/RoomApp";
    QProcess::startDetached(app_path);
    }
    
    
    
    3. Compile the project and copy the RoomApp compilation result RoomApp.app to the same level as the output of the current project. Here, the path of the project created in the above figure is taken as an example: Copy RoomApp.app to the /Users/mac/Desktop/TestApp/build-TestApp-Desktop_Qt_5_9_1_clang_64bit-Release directory.
    4. Run the program to start TestApp and RoomApp at the same time.

    Customizing your own UI

    You can modify the application we provide and adapt it to your needs. You can also use the Module module in the application source code to customize your own UI.
    The Module module in the source code encapsulates the TRTC and Chat SDKs. You can view the API functions and other definitions provided by this module in TUIRoomCore.h, TUIRoomCoreCallback.h, and TUIRoomDef.h files and use the corresponding APIs to implement your own custom UI.
    The App directory contains UI design and logic. You can modify the RoomApp source code for secondary development. The main features are described below:
    Feature
    File Directory
    Homepage login
    Windows-Mac\\RoomApp\\App\\LoginViewController.cpp
    Device testing
    Windows-Mac\\RoomApp\\App\\PresetDeviceController.cpp
    Main UI
    Windows-Mac\\RoomApp\\App\\MainWindow.cpp
    Speaker list
    Windows-Mac\\RoomApp\\App\\StageListController.cpp
    Member lists
    Windows-Mac\\RoomApp\\App\\MemberListViewController.cpp
    Settings page
    Windows-Mac\\RoomApp\\App\\SettingViewController.cpp
    Chat room
    Windows-Mac\\RoomApp\\App\\ChatRoomViewController.cpp
    Screen sharing
    Windows-Mac\\RoomApp\\App\\ScreenShareWindow.cpp
    Bottom toolbar
    Windows-Mac\\RoomApp\\App\\BottomBarController.cpp

    Suggestions and Feedback

    If you have any suggestions or feedback, please contact colleenyu@tencent.com.
    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