# 连麦功能实现说明（简化版）

## 功能概述

在 `SCLivePusherViewController`（直播推流页面）中添加了连麦功能，使用简单的 UIAlertController 列表选择连麦对象。

## 实现的功能

### 1. 连麦按钮
- 位置：右上角，关闭按钮左侧
- 图标：
  - 未连麦状态：`person.2.wave.2`（两个人挥手）
  - 连麦中状态：`person.2.slash`（两个人被划掉）
- 显示时机：开始直播后显示，结束直播时隐藏
- 背景色：
  - 未连麦：半透明灰色
  - 连麦中：红色

### 2. 连麦流程

#### 开始连麦
1. 点击连麦按钮
2. 显示 "正在获取直播列表..." 加载提示
3. 调用 API 获取正在直播的用户列表
4. 弹出 ActionSheet 样式的列表，显示 "流ID: xxx" 格式
5. 选择一个流ID后：
   - UI 切换到双屏模式
   - 左侧：本地推流画面
   - 右侧：连麦用户画面
   - 单个视图宽度：`(屏幕宽度 - 8px) / 2`
   - 宽高比：9:16

#### 断开连麦
1. 再次点击连麦按钮
2. 停止连麦播放器
3. UI 恢复全屏模式
4. 按钮恢复未连麦状态

### 3. 自动处理
- 结束直播时自动断开连麦
- 页面退出时自动断开连麦
- 播放器出错时自动断开并提示用户

## 修改的文件

### SCLivePusherViewController.h
- 添加 `isLinking` 属性：连麦状态
- 添加 `linkingStream` 属性：连麦流信息

### SCLivePusherViewController.m
新增导入：
- `<AFNetworking/AFNetworking.h>`
- `<YYModel/YYModel.h>`
- `AVLiveStreamModel.h`
- `AVConstants.h`

新增属性：
- `linkButton`：连麦按钮
- `linkPlayer`：连麦播放器
- `linkPlayerView`：连麦播放器视图
- `localPusherView`：本地推流视图

新增方法：
- `linkButtonTapped`：连麦按钮点击
- `showLiveStreamSelector`：获取并显示直播列表
- `showStreamListWithStreams:`：显示流ID选择列表
- `startLinkWithStream:`：开始连麦
- `setupLinkViews`：设置双屏布局
- `startLinkPlayer`：启动连麦播放器
- `disconnectLink`：断开连麦
- 实现 `SellyLivePlayerDelegate` 代理方法

## UI 展示

### 连麦列表（UIAlertController）
```
┌─────────────────────────┐
│   选择连麦用户           │
│   请选择要连麦的直播流    │
│                         │
│   流ID: stream_001      │
│   流ID: stream_002      │
│   流ID: stream_003      │
│                         │
│   取消                   │
└─────────────────────────┘
```

### 双屏布局
```
连麦前：              连麦中：
┌─────────────┐      ┌──────┬──────┐
│             │      │      │      │
│   全屏直播   │  →  │ 本地 │ 连麦 │
│             │      │ 9:16 │ 9:16 │
└─────────────┘      └──────┴──────┘
                      ← 8px间距 →
```

## 播放器状态

```objective-c
typedef NS_ENUM(NSInteger, SellyPlayerState) {
    SellyPlayerStateIdle = 0,           // 空闲
    SellyPlayerStateConnecting = 1,     // 连接中
    SellyPlayerStatePlaying = 2,        // 播放中
    SellyPlayerStatePaused = 3,         // 已暂停
    SellyPlayerStateStoppedOrEnded = 4, // 已停止
    SellyPlayerStateFailed = 5          // 失败（自动断开连麦）
};
```

## 依赖说明

项目需要集成：
- SellyCloudSDK（直播推拉流）
- AFNetworking（网络请求）
- YYModel（JSON 解析）
- Masonry（Auto Layout）

常量配置（AVConstants.h）：
- `V_HOST`
- `APP_ID`
- `APP_SECRET`

## 优化点

相比完整版选择器：
1. ✅ 无需额外创建自定义视图控制器
2. ✅ 使用系统原生 UIAlertController，更轻量
3. ✅ 只显示流ID，简单直观
4. ✅ 代码更少，维护更简单
5. ✅ 自动适配 iPhone 和 iPad

## 注意事项

1. 连麦功能仅在直播中可用
2. 暂不支持横屏连麦
3. 网络错误会有友好提示
4. 空列表会提示 "暂无正在直播的用户"