English | 简体中文

TUIKit_iOS is a powerful UI component library built on top of Tencent Cloud's AtomicXCore SDK. AtomicXCore integrates the core capabilities of Tencent Cloud Real-Time Communication (TRTC), Instant Messaging (IM), Audio/Video Calling (TUICallEngine), and Room Management (TUIRoomEngine), providing a state-driven API design.

TUIKit_iOS provides a set of pre-built user interfaces (UI) on top of the core capabilities offered by AtomicXCore, enabling you to quickly integrate video live streaming, voice chat rooms, audio/video calling, and other features into your iOS applications without worrying about complex backend logic and state management.

TUIKit_iOS provides complete UI implementations for the following core business scenarios based on AtomicXCore:

• Video/Voice Live Streaming:

  • Live Room Management: Fetch live room lists.
  • Broadcasting & Watching: Create live rooms, join live streams.
  • Seat Management: Support seat management, audience mic on/off.
  • Host Co-hosting: Support cross-room co-hosting between hosts.
  • Host PK (Battle): Support PK interactions between hosts.
  • Interactive Features:
    • Gifts: Support sending and receiving gifts.
    • Likes: Support live room likes.
    • Barrage: Support sending and receiving barrage messages.

• Audio/Video Calling:

  • Basic Calling: Support 1v1 and multi-party audio/video calls.
  • Call Management: Support answering, rejecting, and hanging up calls.
  • Device Management: Support camera and microphone control during calls.
  • Call History: Support querying and deleting call records.

• Instant Messaging (Chat):

  • Conversation Management: Support fetching and managing conversation lists.
  • Message Sending/Receiving: Support C2C (one-to-one) and Group chat scenarios, with multiple message types including text, images, voice, video, etc.
  • Contact Management: Support friend and blacklist management.
  • Group Management: Support group profile, group member, and group settings management.

• Xcode 14.0 or higher
• iOS 14.0 or higher
• CocoaPods (ensure it's installed)

git clone https://github.com/Tencent-RTC/TUIKit_iOS.git

TUIKit_iOS depends on AtomicXCore, which in turn depends on RTCRoomEngine. You need to use CocoaPods to install these dependencies.

cd TUIKit_iOS/application
pod install

Open the generated .xcworkspace file with Xcode, configure your Tencent Cloud SDKAppID, UserID, and UserSig (usually configured in the GenerateTestUserSig file), then compile and run.

The architecture design of TUIKit_iOS follows layered principles:

1. TUIKit_iOS (UI Layer):

   • Provides pre-built, reusable UI components.
   • Responsible for view presentation and user interaction.
   • Subscribes to Store in AtomicXCore to get state and update UI.
   • Calls Store methods in AtomicXCore to respond to user operations.

2. AtomicXCore (Core Layer):

   • Stores: (such as LiveListStore, CallListStore, ConversationListStore) responsible for managing business logic and state.
   • Core Views: (such as LiveCoreView, ParticipantView) provide UI-less view containers that drive video rendering.
   • Engine Wrapper: Encapsulates underlying RTCRoomEngine, TUICallEngine, and IMSDK, providing unified APIs.

3. Tencent Cloud SDK (Engine Layer):

   • RTCRoomEngine & TUICallEngine: Provide underlying real-time audio/video capabilities.
   • IMSDK: Provides instant messaging capabilities.

• AtomicXCore Documentation
• Official Documentation - Quick Integration Guide

This project is licensed under the MIT License.

---

TUIKit_iOS/
├── application/           # Demo application
│   ├── App-UIKit.xcodeproj
│   ├── App-UIKit.xcworkspace
│   └── Podfile
├── atomic_x/             # AtomicX UI components
│   ├── Sources/          # Swift source files
│   └── Resources/        # UI resources
├── call/                 # TUICallKit components
├── chat/                 # Chat UI components
├── conference/           # Conference/Room UI components
├── live/                 # Live streaming components
└── devops/              # Build and deployment scripts

Before you begin development, ensure you have:

1. Development Environment:

   • macOS with Xcode 14.0+
   • iOS 14.0+ deployment target
   • CocoaPods installed

2. Tencent Cloud Account:

   • SDKAppID from Tencent Cloud Console
   • Valid UserSig for testing

1. Clone and Setup:

   git clone https://github.com/Tencent-RTC/TUIKit_iOS.git
   cd TUIKit_iOS/application
   pod install
   

2. Configure Credentials:

   • Open App-UIKit.xcworkspace in Xcode
   • Navigate to GenerateTestUserSig.swift
   • Replace placeholder values with your actual SDKAppID and SecretKey

3. Build and Run:

   • Select your target device or simulator
   • Press Cmd+R to build and run

To integrate TUIKit_iOS into your existing project:

1. Add Podfile Dependencies:

   pod 'AtomicX'
   pod 'TUICallKit_Swift'
   pod 'TUIRoomKit'
   pod 'TUILiveKit'
   

2. Import and Initialize:

   import AtomicXCore
   import AtomicX
   
   // Initialize in your AppDelegate
   func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
       // Configure AtomicXCore with your credentials
       return true
   }
   

3. Use UI Components:

   import AtomicX
   
   // Example: Add a call view
   let callView = CallView()
   view.addSubview(callView)
   

We welcome contributions! Please see our Contributing Guide for details on how to submit pull requests, report issues, and contribute to the project.

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Make your changes following our coding standards
4. Add tests for your changes
5. Ensure all tests pass
6. Commit your changes (git commit -m 'Add amazing feature')
7. Push to the branch (git push origin feature/amazing-feature)
8. Open a Pull Request

• Documentation: Official Documentation
• API Reference: AtomicXCore API
• Issues: GitHub Issues
• Community: Tencent Cloud Developer Community

See CHANGELOG.md for a detailed history of changes to this project.

• Built with Tencent Cloud TRTC
• UI framework powered by SnapKit
• Image loading by Kingfisher