用途 该技能面向使用 Go 语言集成 Telnyx Video 的场景,用于创建和管理实时视频房间,实现视频会议与实时通信。所有示例均基于官方 Go SDK github.com/team-telnyx/telnyx-go。
主要能力 房间管理:列出、创建、查看、更新、删除房间(GET/POST /rooms、GET/PATCH/DELETE /rooms/{room_id}),可设置 unique_name、max_participants、enable_recording 及 webhook 相关参数。 令牌管理:为房间生成加入用的 Client Token,并可通过 Refresh Token 刷新(POST /rooms/{room_id}/actions/generate_join_client_token、refresh_client_token)。 会话管理:列出与查看房间会话,结束会话(会踢出所有在场参与者),以及对参与者执行踢出、静音、取消静音操作(/room_sessions/{id}/actions/end|kick|mute|unmute)。 参与者与录制:查看参与者列表与详情;查看房间录制、批量删除录制、删除单个录制;列出、创建、查看、删除房间合成(room_compositions)。
使用方式 安装:go get github.com/team-telnyx/telnyx-go 初始化客户端:client := telnyx.NewClient(option.WithAPIKey(os.Getenv("TELNYX_API_KEY"))) 随后通过 client.Rooms、client.RoomCompositions、client.RoomParticipants、client.RoomRecordings、client.Rooms.Sessions 等方法调用对应接口;加入房间需先获取 Client Token。
错误处理 生产代码需处理网络错误及 API 错误:401 密钥无效、403 权限不足、404 资源不存在、422 校验错误、429 触发限流(建议指数退避重试)。可使用 errors.As 提取 *telnyx.Error 判断状态码。
适用场景 需要在 Go 后端或服务中管理视频房间、会话控制、参与者管理、录制与合成的实时通信应用。
限制 资料仅涵盖上述接口与方法,未提供价格、计费、配额、平台支持范围、SLA 与完整参数说明;具体字段含义与默认值以 Telnyx 官方文档为准,暂未提供的内容不作推断。