Tencentcloud Trtc Expert

---
name: tencentcloud-trtc-expert
kind: tool
version: 1.0.0
tags:
  - domain: tools
  - subtype: tencentcloud-trtc-expert
  - level: expert
description: 腾讯云实时音视频TRTC：实时通话、直播连麦、音视频SDK接入。Use when building real-time video/audio applications. Triggers: 'TRTC', '实时音视频', '视频通话', '直播连麦'. Works with: Claude Code, Codex, OpenCode, Cursor, Cline, OpenClaw, Kimi.
license: MIT
metadata:
  author: theNeoAI <lucas_hsueh@hotmail.com>
---

# Tencent TRTC Expert

## Decision Framework

| Scenario | TRTC Mode | Notes |
|----------|-----------|-------|
| 1v1视频通话 | TRTCCall | 快速集成 |
| 多人会议 | TRTCMeeting | 会议场景 |
| 互动直播 | TRTCLiveRoom | 直播连麦 |
| 在线教育 | TRTCClass | 教育场景 |

---

## § 2 · What This Skill Does

1. **快速接入** — SDK集成
2. **房间管理** — 实时通话
3. **直播** — 连麦互动

---

## § 3 · Platform Support

**[URL]:** `https://raw.githubusercontent.com/theneoai/awesome-skills/main/skills/tools/cn-cloud/tencent/tencentcloud-trtc-expert.md`

---

## § 4 · Pricing

| 计费项 | 价格 | 说明 |
|--------|------|------|
| 视频通话 | ¥0.004/分钟·人 | 720P |
| 语音通话 | ¥0.001/分钟·人 | - |
| 直播 | ¥0.001/分钟·人 | 观众不收费 |

---

## § 5 · SDK Integration

### 5.1 Web SDK

```javascript
import TRTC from 'trtc-js-sdk';

const client = TRTC.createClient({
  sdkAppId: 1400000000,
  userId: 'user_' + Math.random(),
  userSig: '生成的签名',
  mode: 'rtc'
});

// 加入房间
await client.join({ roomId: 123456 });

// 创建本地流
const localStream = TRTC.createStream({
  audio: true,
  video: true,
  userId: 'user_' + Math.random()
});

// 订阅并播放
await client.subscribe(remoteStream);
remoteStream.play('remote-container-' + stream.getUserId());
```

### 5.2 UserSig生成

```python
import hmac
import hashlib
import base64
import time

def gen_user_sig(sdkappid, user_id, secret_key, expire=86400):
    # 过期时间
    curr_time = int(time.time())
    expire_time = curr_time + expire

    # 组成签名串
    sig_content = f"sdkappid={sdkappid}&userid={user_id}&currtime={curr_time}&expire={expire_time}"

    # 生成签名
    sig = hmac.new(
        secret_key.encode(),
        sig_content.encode(),
        hashlib.sha256
    ).digest()
    sig = base64.b64encode(sig).decode()

    return sig
```

---

## § 6 · Standards & Reference

### 6.1 关键参数

| 参数 | 说明 |
|------|------|
| sdkAppId | 应用ID |
| userId | 用户标识 |
| userSig | 用户签名 |
| roomId | 房间号 |

### 6.2 房间操作

```javascript
// 进入房间
await client.join({ roomId: 123456, role: 'anchor' });

// 离开房间
await client.leave();

// 开关摄像头
localStream.muteVideo();
localStream.unmuteVideo();

// 开关麦克风
localStream.muteAudio();
localStream.unmuteAudio();
```

---

## § 7 · Risk Disclaimer

| 风险 | 级别 | 建议 |
|------|------|------|
| 通话质量差 | 🟡 | 检查网络/设备 |
| 并发超限 | 🟡 | 升级套餐 |
| 安全问题 | 🟡 | UserSig后端生成 |

---

## 9.1 在线视频会议

**User:** "搭建视频会议系统"

**Expert:**
> 1. 开通TRTC服务
> 2. 生成UserSig（后端）
> 3. 集成SDK：
> ```javascript
> const client = TRTC.createClient({ sdkAppId, userId, userSig });
> await client.join({ roomId: meetingRoomId, role: 'anchor' });
>
> // 展示所有参与者
> client.on('stream-subscribed', ({ stream }) => {
>   stream.play('container-' + stream.getUserId());
> });
> ```
> 4. 添加屏幕共享
> 5. 实现聊天/白板

### 9.2 直播连麦

**User:** "互动直播功能"

**Expert:**
> 1. 使用直播模式
> 2. 主播加入：role: 'anchor'
> 3. 观众连麦：
> ```javascript
> // 观众申请连麦
> await client.switchRole('anchor');
> await client.publish(localStream);
>
> // 主播处理连麦请求
> await client.accept(remoteStream);
> ```

### 9.3 语音聊天室

**User:** "语音社交应用"

**Expert:**
> 1. 只开启音频
> ```javascript
> const localStream = TRTC.createStream({
>   audio: true,
>   video: false
> });
> ```
> 2. 配置角色权限
> 3. 实现上麦/下麦

---


## § 8 · Workflow

### Phase 1: Discovery & Assessment

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Fully understand the problem context and requirements.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Context Gathering** — Collect relevant background information and data
2. **Stakeholder Mapping** — Identify all affected parties and their needs
3. **Requirements Definition** — Document explicit and implicit requirements
4. **Constraint Analysis** — Identify limitations, boundaries, and dependencies

**✓ Done Criteria:**
- [✓] Problem statement clearly defined and documented
- [✓] All stakeholders identified and engaged
- [✓] Success metrics established and agreed upon
- [✓] Constraints documented and acknowledged

**✗ Fail Criteria:**
- [✗] Requirements remain ambiguous or undefined
- [✗] Critical stakeholders excluded from process
- [✗] Success criteria not measurable
- [✗] Constraints ignored or violated

### Phase 2: Analysis & Strategy

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Develop a comprehensive solution strategy.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Root Cause Analysis** — Identify underlying issues (5 Whys, Fishbone)
2. **Option Generation** — Develop multiple solution alternatives
3. **Risk Assessment** — Evaluate potential risks and mitigation strategies
4. **Resource Planning** — Define required resources, timeline, and budget

**✓ Done Criteria:**
- [✓] Root causes identified and validated
- [✓] At least 3 solution options evaluated with trade-offs
- [✓] Risks assessed with mitigation plans
- [✓] Resources and timeline committed

**✗ Fail Criteria:**
- [✗] Addressing symptoms, not root causes
- [✗] Only one solution considered
- [✗] Risks ignored or underestimated
- [✗] Insufficient resources allocated

### Phase 3: Implementation & Execution

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Execute the chosen solution with quality and efficiency.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Detailed Planning** — Create actionable implementation plan
2. **Progress Tracking** — Monitor milestones and deliverables
3. **Quality Assurance** — Validate outputs meet standards
4. **Communication** — Keep stakeholders informed

**✓ Done Criteria:**
- [✓] All planned activities completed
- [✓] Stakeholders informed at each milestone
- [✓] Quality checkpoints passed
- [✓] Documentation current and complete

**✗ Fail Criteria:**
- [✗] Activities rushed or skipped
- [✗] Stakeholders surprised by changes
- [✗] Quality issues discovered late
- [✗] Documentation missing or outdated

### Phase 4: Review & Optimization

| **Done** | Phase completed |
| **Fail** | Criteria not met |

**Objective:** Validate results and capture learnings.

| **Done** | All tasks completed |
| **Fail** | Tasks incomplete |

**Key Activities:**
1. **Outcome Evaluation** — Measure against success criteria
2. **Feedback Collection** — Gather stakeholder input
3. **Lessons Learned** — Document insights and improvements
4. **Knowledge Transfer** — Share findings with organization

**✓ Done Criteria:**
- [✓] Success metrics achieved or understood
- [✓] Feedback incorporated for future work
- [✓] Lessons documented and shared
- [✓] Knowledge artifacts created

**✗ Fail Criteria:**
- [✗] Success criteria not measured
- [✗] Feedback ignored or dismissed
- [✗] Same mistakes likely to recur
- [✗] Knowledge lost or siloed

---

## § 9 · Scenario Examples

### Scenario 1: Initial Consultation

**Context:**
A new client or stakeholder needs expert guidance on a tencentcloud trtc expert matter.

**User Input:**
"I'm new to this area and need help understanding [specific problem]. Where should I start?"

**Expert Response:**
Welcome! I'm here to help you navigate this tencentcloud trtc expert challenge effectively. Let me start by understanding your situation better.

**1. Assessment Questions:**
- What is your current level of experience with this topic?
- What are your immediate goals or deadlines?
- Do you have any specific constraints (budget, resources, timeline)?
- Who else is involved in this project?

**2. Initial Guidance:**
Based on typical patterns, I recommend we start with:
- **Phase 1: Assessment** — Clearly define what success looks like
- **Phase 2: Strategy** — Develop a tailored approach
- **Phase 3: Execution** — Implement with proper checkpoints

**3. Next Steps:**
Please share more details about your specific situation, and I'll provide targeted recommendations.

---

### Scenario 2: Complex Problem Solving

**Context:**
An urgent, complex tencentcloud trtc expert issue requires immediate expert intervention.

**User Input:**
"We have a critical situation: [describe urgent problem]. We need a solution within [timeframe]."

**Expert Response:**
I understand the urgency. Let's work through this systematically to ensure we don't miss critical elements.

**1. Triage (First 5 minutes):**
```
[Urgency Assessment]
- Impact Level: [Critical/High/Medium/Low]
- Time Critical: [Yes/No]
- Reversibility: [Reversible/Irreversible]
```

**2. Immediate Stabilization:**
If this is a "bleeding" situation, immediate actions:
- [Stabilization action 1]
- [Stabilization action 2]
- [Communication to stakeholders]

**3. Root Cause Analysis:**
Once stabilized, let's understand what caused this:
```
[5 Whys Analysis]
Why did this happen? → [Answer]
  Why did [Answer]? → [Answer]
    Continue until root cause identified...
```

**4. Solution Development:**
Based on root cause, here are 3 options:
| Option | Approach | Risk | Effort | Timeline |
|--------|----------|------|--------|----------|
| A | Quick fix | High | Low | 1 day |
| B | Balanced | Medium | Medium | 1 week |
| C | Complete | Low | High | 1 month |

**Recommendation:** [Specific recommendation with rationale]

---

### Scenario 3: Strategic Planning

**Context:**
Long-term tencentcloud trtc expert strategy development for sustained excellence.

**User Input:**
"We want to build world-class capability in tencentcloud trtc expert. What's our roadmap?"

**Expert Response:**
Building world-class capability is a journey. Here's a strategic framework:

**Phase 1: Foundation (Months 1-3)**
```
Goals:
- Establish baseline assessment
- Define capability maturity model
- Identify quick wins

Key Activities:
□ Comprehensive assessment
□ Best practice research
□ Team skill mapping
□ Quick win identification

Milestone: Foundation Report + Quick Win Implementation
```

**Phase 2: Acceleration (Months 4-9)**
```
Goals:
- Implement core systems
- Upskill team members
- Establish metrics and KPIs

Key Activities:
□ System implementation
□ Training programs
□ Process standardization
□ Performance tracking

Milestone: Operational Excellence Framework
```

**Phase 3: Optimization (Months 10-18)**
```
Goals:
- Continuous improvement culture
- Advanced methodology adoption
- Innovation integration

Key Activities:
□ Maturity assessment
□ Advanced techniques
□ Innovation pipeline
□ Knowledge management

Milestone: World-Class Capability Certification
```

**Success Metrics:**
| Dimension | Baseline | 6 Months | 12 Months | 18 Months |
|-----------|----------|----------|-----------|-----------|
| Efficiency | X% | +20% | +40% | +60% |
| Quality | X defects | -30% | -50% | -70% |
| Speed | X days | -25% | -40% | -50% |
| Innovation | 0/year | 2/year | 5/year | 10/year |

**Investment Required:**
- Human Capital: [FTE estimates]
- Financial: [Budget ranges]
- Timeline: [Phased commitment]

**Risk Mitigation:**
🔴 **High Risk:** [Risk] → Mitigation: [Action]
🟡 **Medium Risk:** [Risk] → Mitigation: [Action]
🟢 **Low Risk:** [Risk] → Mitigation: [Action]

---

### Scenario 4: Quality Assurance & Review

**Context:**
Project or deliverable requires quality verification and optimization.

**User Input:**
"Can you review our [deliverable] and help us improve quality before final delivery?"

**Expert Response:**
Absolutely. Let me conduct a comprehensive quality review using established frameworks.

**1. Quality Checklist:**
- [ ] Requirements alignment verified
- [ ] Standards compliance confirmed
- [ ] Best practices applied
- [ ] Edge cases considered
- [ ] Documentation complete

**2. Gap Analysis:**
| Aspect | Current | Target | Gap | Priority |
|--------|---------|--------|-----|----------|
| Completeness | 80% | 100% | 20% | High |
| Accuracy | 90% | 100% | 10% | High |
| Usability | 70% | 95% | 25% | Medium |

**3. Improvement Plan:**
- **Immediate fixes** (Today): [List]
- **Short-term** (This week): [List]
- **Long-term** (Next month): [List]

**4. Final Validation:**
Before sign-off, ensure:
- ✓ All acceptance criteria met
- ✓ Stakeholder approval obtained
- ✓ Handover documentation ready

---

## § 10 · Edge Cases

| 问题 | 解决方案 |
|------|----------|
| 对方听不到 | 检查麦克风权限 |
| 画面黑屏 | 检查摄像头 |
| 延迟高 | 选择更近的服务器 |
| 回声/噪音 | 开启降噪 |

---

## § 11 · Quality Monitoring

| 指标 | 正常值 |
|------|--------|
| 视频帧率 | 15-30fps |
| 音频码率 | 40-60kbps |
| 视频码率 | 500-2000kbps |
| 丢包率 | <5% |

---

## § 12 · Scope & Limitations

**In Scope:**
- TRTC SDK integration
- Audio/video call implementation
- Live streaming with co-anchoring

**Out of Scope:**
- Complex video processing
- Recording infrastructure
- CDN distribution

---


## § 14 · Quality Verification

→ See references/standards.md §7.10 for full checklist
## § 20 · Case Studies

### Success Story 1: Transformation
**Challenge:** Legacy system limitations
**Results:** 40% performance improvement, 50% cost reduction

### Success Story 2: Innovation  
**Challenge:** Market disruption
**Results:** New revenue stream, competitive advantage


---


## Anti-Patterns

| Pattern | Avoid | Instead |
|---------|-------|---------|
| Generic | Vague claims | Specific data |
| Skipping | Missing validations | Full verification |