terryso 功能说明
创建一个新的保利威直播频道，返回频道 ID 和基本信息。
参数
| 参数 | 必填 | 类型 | 说明 | 默认值 |
|---|---|---|---|---|
| name | 是 | string | 频道名称，最大 100 字符 | - |
| scene | 否 | string | 直播场景：topclass(大班课), train(企业培训), alone(活动营销) | topclass |
| template | 否 | string | 直播模板：ppt(三分屏), alone(纯视频) | ppt |
示例
示例 1：简单创建 用户：帮我创建一个直播频道叫"产品发布会"
示例 2：指定场景 用户：创建一个企业培训直播，名称是"新员工入职培训" 参数：name="新员工入职培训", scene="train"
示例 3：完整参数 用户：创建一个纯视频直播，名称是"年会直播"，使用纯视频模板 参数：name="年会直播", scene="alone", template="alone"
CLI 调用
node scripts/polyv.js create-channel --name "<频道名称>" [--scene <场景>] [--template <模板>]
输出格式
成功响应：
✅ 频道创建成功！
频道 ID: 3151318
用户 ID: xxx
错误响应：
❌ [POLYV-CONFIG_MISSING] 缺少 appId 配置
提示：请设置 POLYV_APP_ID 环境变量，或创建配置文件 ~/.polyv-skills/config.json
错误处理
| 错误码 | 说明 | 解决方案 |
|---|---|---|
| CONFIG_MISSING | 凭据未配置 | 设置环境变量或创建配置文件 |
| API_ERROR | API 调用失败 | 检查网络和凭据有效性 |
| NETWORK_ERROR | 网络错误 | 检查网络连接 |
| 400 | 请求参数错误 | 检查请求参数是否正确 |
| 401 | 签名验证失败 | 检查 appId 和 appSecret 是否正确 |
| 403 | 无权限访问 | 检查账号权限 |
| 429 | 请求过于频繁 | 请稍后重试 |
| 500 | 服务器内部错误 | 请稍后重试或联系技术支持 |
网络错误类型
| 错误类型 | 说明 | 解决方案 |
|---|---|---|
| DNS 解析失败 | 无法解析 API 域名 | 检查网络连接或 DNS 配置 |
| 连接被拒绝 | 服务器无法连接 | 服务器无法连接，请稍后重试 |
| 请求超时 | 服务器响应超时 | 服务器响应超时，请稍后重试 |
Debug 模式
当需要排查问题时，可以启用 Debug 模式获取详细的调试信息：
# 启用 Debug 模式
export POLYV_DEBUG=true
node scripts/polyv.js create-channel --name "测试频道"
Debug 模式会输出：
- 请求 URL 和端点
- 请求参数（appSecret 会自动脱敏显示为
ab****yz格式） - API 响应内容
- 时间戳信息
安全说明： Debug 模式下 appSecret 会被脱敏处理，不会在日志中显示完整密钥。
注意事项
- 首次使用需要配置 polyv 凭据（appId 和 appSecret）
- 频道名称为必填参数
- 场景和模板有默认值，通常无需指定
- 配置优先级：CLI 参数 > 环境变量 > 配置文件
高级用法
当需要更多控制时（如设置讲师密码、延迟模式、连麦人数等），请参阅 高级参数指南。
常见高级场景：
- 低延迟直播：
--pureRtcEnabled Y - 自定义密码：
--channelPasswd "abc123456" - 连麦人数：
--linkMicLimit 8