产品结构与开发边界
AKStream.Next 控制服务提供统一 API、业务资源与权限;节点/Node Agent 执行媒体和宿主操作;MediaServer 处理媒体收发、转发和录像。控制地址、节点地址、媒体地址可能不同,不把页面 Host 硬编码成所有媒体连接地址,使用返回的受控 URL 和 SDK 会话上下文。
第三方业务应用分为自己的业务后端、自己的前端和平台运行实例。业务后端负责真实用户、资源映射及平台 Token 保管;前端访问自己的后端取得短时资源授权。公开 WebUI 是调用范例,也可在交付的源码基础上定制;RTC SDK 提供会议客户端核心,Demo 展示布局和宿主接入。
平台服务端不是源码交付项目。客户可修改 WebUI、SDK、Demo 和自己的应用;通过平台公开配置/API 进行运行管理。不直接操作平台表、创建私有服务端模块、复制节点服务密钥或依赖内部类型。需要新服务端能力时明确提出 API 扩展需求。
稳定引用包括 clusterId、nodeId、mediaServerId、deviceId、channelId、fileId、taskId、roomId、participantId、deviceSessionId、publicationId、subscriptionId。按接口模型选用,名称不能代替 ID。统一 channelId 优先用于通道业务映射;app/stream/vhost 与节点定位来自返回值。
WebUI 浏览器通常使用 Cookie 会话和 CSRF;第三方后端用 Bearer API Token。RTC 票据入会后得到逐会议、逐设备的参会身份,不能调用平台管理接口。媒体短票据只准指定资源/动作。授权额度、账号权限、Token 权限、会议角色和设备能力都是实际能力边界。
获取同版交付物,保留源码包已有的依赖锁文件、SDK 资源和离线白板资源。不要自行安装公共仓库同名 SDK 并认定兼容。交付包组件可选:缺 WebUI/SDK 源码时使用随版契约对接 API,RTC 则向交付方取得相匹配的 SDK,不依赖服务器私有源码。