用途:该技能面向 Ruby 开发者,用于通过 Telnyx API 创建和管理实时视频房间与会议,覆盖房间、会话、参与者、录制和视频合成等操作。
主要能力:房间管理(创建、查询、更新、删除,可设置 max_participants、enable_recording、unique_name、Webhook 地址与超时);会话管理(列出、查询、结束会话、踢出、静音与取消静音参与者);参与者查询;录制查询、删除与批量删除;房间合成(room_compositions)的列出、异步创建、查询与删除;以及生成和刷新加入房间所需的 Client Token。
使用方式:安装 gem install telnyx,然后用 require "telnyx" 初始化 client = Telnyx::Client.new(api_key: ENV["TELNYX_API_KEY"])。之后调用对应资源方法,例如 client.rooms.create(unique_name: "my-meeting-room", max_participants: 10)、client.rooms.retrieve(...)、client.rooms.sessions.actions.end_(...)、client.room_recordings.list 等。
限制与注意:API 调用可能返回 401、403、404、422、429 等错误,资料建议在生产代码中处理网络、限流与验证错误,限流可按 Retry-After 退避重试。Client Token 与 Refresh Token 均有过期时间,需按 token_ttl_secs 与 refresh_token_ttl_secs 管理。删除房间会踢出参与者并停止计费。资料未提供具体价格、平台覆盖范围或完整产品限制说明。