tencent cloud

Tencent Real-Time Communication

소식 및 공지 사항
제품 업데이트
Tencent Cloud 오디오/비디오 단말 SDK 재생 업그레이드 및 권한 부여 인증 추가
TRTC 월간 구독 패키지 출시 관련 안내
제품 소개
제품 개요
기본 개념
제품 기능
제품 장점
응용 시나리오
성능 데이터
구매 가이드
Billing Overview
무료 시간 안내
Monthly subscription
Pay-as-you-go
TRTC Overdue and Suspension Policy
과금 FAQ
Refund Instructions
신규 사용자 가이드
Demo 체험
Call
개요(TUICallKit)
Activate the Service
Run Demo
빠른 통합(TUICallKit)
오프라인 푸시
Conversational Chat
온클라우드 녹화(TUICallKit)
AI Noise Reduction
UI 사용자 정의
Calls integration to Chat
Additional Features
No UI Integration
Server APIs
Client APIs
Solution
ErrorCode
릴리스 노트
FAQs
라이브 스트리밍
Billing of Video Live Component
Overview
Activating the Service (TUILiveKit)
Demo 실행
No UI Integration
UI Customization
Live Broadcast Monitoring
Video Live Streaming
Voice Chat Room
Advanced Features
Client APIs
Server APIs
Error Codes
Release Notes
FAQs
RTC Engine
Activate Service
SDK 다운로드
API 코드 예시
Usage Guidelines
API 클라이언트 API
고급 기능
RTC RESTFUL API
History
Introduction
API Category
Room Management APIs
Stream mixing and relay APIs
On-cloud recording APIs
Data Monitoring APIs
Pull stream Relay Related interface
Web Record APIs
AI Service APIs
Cloud Slicing APIs
Cloud Moderation APIs
Making API Requests
Call Quality Monitoring APIs
Usage Statistics APIs
Data Types
Appendix
Error Codes
콘솔 가이드
애플리케이션 관리
사용량 통계
모니터링 대시보드
개발 보조
Solution
Real-Time Chorus
FAQs
과금 개요
기능 관련
UserSig 관련
방화벽 제한 처리
설치 패키지 용량 축소 관련 질문
Andriod 및 iOS 관련
Web 관련
Flutter 관련
Electron 관련
TRTCCalling Web 관련
멀티미디어 품질 관련
기타 질문
Protocols and Policies
컴플라이언스 인증
보안 백서
정보 보안에 관한 참고 사항
Service Level Agreement
Apple Privacy Policy: PrivacyInfo.xcprivacy
TRTC 정책
개인 정보 보호 정책
데이터 처리 및 보안 계약
용어집

Host Live Streaming(iOS)

PDF
포커스 모드
폰트 크기
마지막 업데이트 시간: 2025-12-25 10:20:20
UILiveKit Voice Chat Room is a ready-to-use interface providing all the core functionalities for starting a live stream. It enables you to integrate a host broadcasting flow into your app with simple steps.

Feature Overview

Pre-Live Preview: Allows hosts to configure personalized settings such as room name and cover image before going live.
Seat Management: Supports seat management operations including taking a seat, leaving a seat, muting, and locking seats.
Audience Interaction: Enables interactive features such as live chat (bullet comments), virtual gifts, and likes.
Live Room Management: Displays the online user list and provides moderation controls such as muting or removing users from the live room.
Pre-Live Preview
Seat Management
Audience Interaction
Live Room Management













Quick Integration

Integrate the Component

Follow the Preparation guide to integrate TUILiveKit.

Create and Present the Voice Room View Controller

The TUIVoiceRoomViewController component provides a complete host-side UI and business logic for the voice room scenario. To enable hosts to start a live session, simply create and present this view controller. We recommend triggering the following logic in your app’s "Start Live" button click handler:
import TUILiveKit
import UIKit

// YourViewController represents the view controller from which you start the live session
class YourViewController: UIViewController {

// Handle the "Start Live" button click event
@objc func onStartVoiceRoomClicked() {

// 1. Configure room parameters (RoomParams)
var params = RoomParams()
params.maxSeatCount = 10 // Maximum number of seats
params.seatMode = .applyToTake // Seat mode

// 2. Instantiate the voice room controller
let roomId = "test_voice_room_id"
let voiceRoomVC = TUIVoiceRoomViewController(roomId: roomId, behavior: .prepareCreate, roomParams: params)
voiceRoomVC.modalPresentationStyle = .fullScreen

// 3. Present the voice room page
present(voiceRoomVC, animated: true)
}
}
TUIVoiceRoomViewController Parameter Reference:
Parameter
Type
Description
roomId
string
Globally unique ID for the live room.

behavior

RoomBehavior
Room entry behavior:
- autoCreate: Automatically create and enter the live room.
- prepareCreate: Enter the pre-live preview page first, then create and enter the live room after the user clicks "Start Live".
- join: Audience joins the room.

roomParams

RoomParams?
Parameters for the host to start the live session. See the table below for details.
RoomParams Parameter Reference:
Parameter
Type
Description
maxSeatCount
Int
Maximum number of seats in the live room.
seatMode
TUISeatMode
Audience seat mode:
- applyToTake: Audience must apply and be approved by the host to take a seat.
- freeToTake: Audience can take a seat freely without host approval.

Customize UI

TUILiveKit provides flexible UI customization to meet a variety of business requirements. You can select different layout templates and easily update UI text and icons.

Live Layout Template Selection

TUILiveKit Voice Room offers two layout styles. Select your preferred style using the "Layout" option on the host's pre-live preview page:


Layout Overview:


Chat Room
KTV
Description
Default layout; displays only the seat grid.
Displays a KTV song player above the seat grid.
Preview







Text Customization (Localization)

TUILiveKit uses the Apple Strings Catalog(.xcstrings) format, introduced in Xcode 15, to manage the text displayed in the UI. You can modify the string resources using Xcode's graphical interface:
Note:
Apple Strings Catalog (.xcstrings) is a localization format introduced in Xcode 15. It enhances how developers manage localized strings, supporting a structured format to handle plurals, device-specific variants, etc. This format is becoming the recommended way to manage localization for iOS and macOS applications.


Icon Customization (Image Assets)

TUILiveKit uses TUILiveKit.xcassets to manage the image resources for the UI. You can quickly modify the custom icons using Xcode's graphical tools.


Next Steps

You have now successfully integrated host live streaming. Next, implement features such as audience listening, live stream list and gift system. See the table below for details:
Feature
Description
Integration Guide
Audience Listening
Enables users to join as audience members, listen to the host, take seats, and view live chat (bullet comments).
Live Stream List
Displays a list of live rooms and their details.
Gift System
Support custom gift asset configuration, billing system integration, and gift-sending in PK scenarios.

FAQs

No sound after going live?

Go to your device's Settings > App > Microphone and ensure that microphone permissions are enabled.


Unable to go live when clicking the start button, with a "Not Logged In" prompt?

See Complete Login to ensure login functionality is properly integrated.


도움말 및 지원

문제 해결에 도움이 되었나요?

피드백