call-uikit

What this skill does

# Call TUICallKit Integration Skill (Multi-Platform Aggregation)

> 📌 **Parent Skill**: This is a sub-skill of `tencent-rtc-skills` (root skill).
> If user's intent is ambiguous across products (Chat/Call/Live/Room), load the root skill first for product recommendation.

> **📌 Global Reference**: This sub-skill follows the global standards defined in ROOT SKILL:
> - Skill-First Principle (priority order)
> - Boundary Recognition Pattern
> - MCP Tools Reference (record_prompt, get_usersig, record_result)
> - MCP Tool Call Sequence Pattern
> - Documentation-Driven Integration Rules
> - Silent Execution Rules
> - Zero External Configuration
> - Auto-Fetch Authentication Credentials
> - Agent Execution Checklist Template
>
> Call-specific rules below may EXTEND or OVERRIDE global rules where explicitly noted.

---

## 🔵 Boundary Recognition (Call-Specific)

### Keywords That CONFIRM Call Scope

Only proceed with Call integration if user's request contains:
- call, phone call, video call, voice call
- 1-to-1, one-to-one, peer-to-peer
- dial, answer, hang up, incoming call, ringtone
- TUICallKit, CallKit
- WeChat call-like

### OUT OF SCOPE → Redirect

> **📌 Reference**: See ROOT SKILL for global Boundary Recognition Pattern.

| User Keywords | Redirect To | Reason |
|---------------|-------------|--------|
| "video conference" / "meeting" / "conference" | TUIRoomKit (Room) | Room is designed for meetings with member management and screen sharing |
| "chat" / "IM" / "message" / "instant messaging" | Chat TUIKit | Chat is designed for instant messaging |
| "live streaming" / "host" / "audience" / "gift" | TUILiveKit (Live) | Live is designed for live streaming scenarios |

### ⚠️ Special Case: "video conference" Redirection

**CRITICAL**: When user says "video conference", Agent MUST redirect to Room:

```
User: "Use CallKit to implement video conference"

Agent Response:
"Note: TUICallKit is designed for **peer-to-peer calls** (like WeChat calls), not for conferences.

For **video conference** needs, I strongly recommend **TUIRoomKit (Room)**:
- ✅ Designed specifically for meeting scenarios
- ✅ Supports member management (mute all, kick, roles)
- ✅ Supports screen sharing
- ✅ Suitable for multi-person meetings

If you really need simple 1-to-1 or small group calls (without meeting features), I can continue with TUICallKit.
Please confirm your requirements."
```

---

## Overview

This Skill serves as the **multi-platform aggregation entry point** for Tencent Cloud Call TUICallKit, applicable to the following scenarios:
1. Users need audio/video call features but have not specified a platform/framework
2. Need to understand capability differences and selection recommendations across platforms
3. Need cross-platform common concepts and knowledge

**Platform-Specific Guidance**: Once the platform is determined, please use the corresponding sub-Skill:
- `call/vue` - Vue3 Web Applications
- `call/react` - React Web Applications
- `call/android` - Android Native Applications
- `call/ios` - iOS Native Applications
- `call/flutter` - Flutter Cross-Platform Applications

---

## 🎯 When to Use Call vs Room

### Use Call (TUICallKit) When:

| Scenario | Example | Why Call? |
|----------|---------|-----------|
| **1-to-1 Calls** | Video chat between two friends | Call semantics, ringtone support |
| **Small Group Calls** | Family video call (3-5 people) | Lightweight, call-focused UI |
| **Call with Ringtone** | Incoming call notification needed | Built-in ringtone and call states |
| **Call Status Management** | Show "Ringing...", "Connected", "Ended" | Native call state machine |
| **Quick Integration** | Simple call feature in existing app | Minimal setup, focused API |

### Use Room (TUIRoomKit) Instead When:

| Scenario | Why Room? |
|----------|-----------|
| **Video Conference** | Meeting controls, member management |
| **Screen Sharing Required** | Native screen share support |
| **Large Participant Count** | Optimized for many participants |
| **Meeting Features** | Mute all, roles, agenda |

---

## 🔄 Product Selection Guidance

When user's requirement is ambiguous, clarify:

```
User: "Implement audio/video communication feature"

Agent should ask:
"What is your audio/video communication requirement:
1. **1-to-1 or Small Group Calls** (like WeChat calls, with incoming ringtone) → Recommend TUICallKit
2. **Multi-person Video Conference** (like Tencent Meeting, with member management) → Recommend TUIRoomKit

Please select your scenario, and I will load the corresponding integration guide."
```

---

## Core Features

TUICallKit provides:

### 1. Call Types
- **Voice Call** - Audio-only calls
- **Video Call** - Audio + video calls
- **Group Call** - Multi-person calls (up to 9)

### 2. Call Flow
```
┌─────────┐     ┌─────────┐     ┌─────────┐     ┌─────────┐
│  Idle   │ ──▶ │ Calling │ ──▶ │Connected│ ──▶ │  Ended  │
└─────────┘     └─────────┘     └─────────┘     └─────────┘
                    │               ▲
                    │  (Answer)     │
                    ▼               │
               ┌─────────┐         │
               │ Ringing │ ────────┘
               └─────────┘
```

### 3. UI Components
- **Incoming Call UI** - Shows caller info, accept/reject buttons
- **Calling UI** - Shows callee info, hang up button
- **In-Call UI** - Video view, controls (mute, speaker, camera)
- **Floating Window** - Mini window when app is backgrounded

### 4. Call Features
- Ringtone customization
- Call timeout handling
- Network quality indicators
- Camera/microphone control
- Speaker/earpiece switching

---

## 🔴 Mandatory MCP Tool Usage

> **📌 Reference**: See ROOT SKILL "Global: MCP Tool Call Sequence Pattern" for universal sequence.

### Call-Specific Tools

| Tool | Purpose | When to Use |
|------|---------|-------------|
| `get_native_call_uikit_integration` | Native platform integration guide | For Android/iOS/Flutter |
| `get_web_call_uikit_integration` | Web platform integration guide | For React/Vue |
| `get_web_call_uikit_api` | API documentation | For customization needs |

---

## 📁 Sub-Skill Directory

| Platform | Skill Path | Status |
|----------|------------|--------|
| React Web | `/call/react/SKILL.md` | Planned |
| Vue3 Web | `/call/vue/SKILL.md` | Planned |
| Android | `/call/android/SKILL.md` | Planned |
| iOS | `/call/ios/SKILL.md` | Planned |
| Flutter | `/call/flutter/SKILL.md` | Planned |

---

## Keywords for Intent Matching

When user prompt contains these keywords, this skill (or its sub-skills) should be considered:

**Primary Keywords** (Strong match):
- call, phone call, video call, voice call
- TUICallKit, CallKit
- dial, answer, hang up, incoming call
- 1-to-1, one-to-one, peer-to-peer

**Secondary Keywords** (May also match Room):
- audio/video
- video chat

**Exclusion Keywords** (Prefer other products):
- meeting, conference → Room
- live streaming, host → Live
- chat, IM, message → Chat