37795272/polyv-create-channel

功能说明

创建一个新的保利威直播频道，返回频道 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 会被脱敏处理，不会在日志中显示完整密钥。

注意事项

1. 首次使用需要配置 polyv 凭据（appId 和 appSecret）
2. 频道名称为必填参数
3. 场景和模板有默认值，通常无需指定
4. 配置优先级：CLI 参数 > 环境变量 > 配置文件

高级用法

当需要更多控制时（如设置讲师密码、延迟模式、连麦人数等），请参阅 高级参数指南。

常见高级场景：

• 低延迟直播：--pureRtcEnabled Y
• 自定义密码：--channelPasswd "abc123456"
• 连麦人数：--linkMicLimit 8