tencent cloud

PrevNext

Feedback

search by keyword

Recent Pages

Documentation
Tencent Real-Time Communication
    Documentation
    Download PDF

    Integrating TUIRoom (Windows and macOS)

    Last updated: 2023-10-13 11:30:48
    Download PDF
      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.
      Starting via external process
      Customizing your own UI

      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.

      Contact Us
      Technical Support

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

      Submit a Ticket
      7x24 Phone Support
      Copyright © 2013-2024 Tencent Cloud. All Rights Reserved.
      Privacy PolicyLegalCookie Policy