tencent cloud


Integrating TUIRoom (Windows and macOS)

Last updated: 2022-04-25 10:58:59

    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.

    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 IM 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.
      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";

      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.

    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 IM 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 list 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


    If you have any requirements or feedback, 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