名词解释
控制台
控制台也叫Console
,控制台是 Pano 提供给用户进行应用管理、查询账单、查询用量、提交工单等的管理后台,对应的网址为 https://console.pano.video。注册账号之后,可以通过控制台创建项目、获得App ID、配置项目、查看通话用量、分析通话质量以及查看账单等。
App ID
App也叫项目
或者应用
,每一个App都有一个唯一的App ID。不同的 App ID 在 Pano 中的通话是完全独立的。因此,不同 App ID 的应用之间无法通信。如果需要相互通信,请使用相同的App ID。
在控制台的应用管理模块可以管理应用,可以查看App ID以及App的其他相关信息。
App Client
这是客户的应用程序,可能是iOS App、Android App、Windows应用程序等各种平台下的应用程序,App Client通过集成Pano SDK实现音视频通话功能。App Client有时简称为App。
App Server
客户的应用服务器,用于实现客户自己的业务逻辑,通常在App Server端发起对Pano Cloud的RESTful API调用。App Client和App Server都是客户的程序,由客户自行实现,使用什么开发语言、实现什么业务逻辑、App Client和App Server使用什么方式和协议交互,这些都由客户根据自己的业务逻辑决定。
App Secret
App Secret也叫应用密钥
,每一个App ID都有一个唯一的App Secret。与Pano Cloud的所有RESTful API交互都需要带上由App Secret生成的签名,App Secret相当于是App的密码,属于高度机密信息,请妥善保管。
更多信息请参考权限控制。
Channel ID
Channel也叫频道
,表示一次通话,Channel ID用于唯一标识通话,类型为字符串。Channel ID由开发者传入Pano SDK,开发者需要保证Channel ID的唯一性。使用相同Channel ID加会的用户会加入同一个频道。
Channel ID的命名规则请参考Channel ID命名规则。
Channel Key
开发者需要对正在进行的通话保证Channel ID的唯一性,以免串会。对于每一通通话,Pano也会分配一个全局唯一的ID,此ID被称为Channel Key
。
Pano允许不同时间段的通话使用相同的Channel ID,但会为每一次通话分配一个全局唯一的Channel Key
。
假设使用相同的Channel ID在不同时间段进行了两次通话,对于Pano而言这是两次不同的通话,Pano为这两次通话分配的Channel Key是不同的,但是Channel ID是相同的。在RESTful API频道管理的查询通话详情接口里,如果使用Channel ID来查询,Pano将会返回一个数组,两次通话的数据都会返回,开发者需要自行区分这两次通话的对应关系。
Channel Mode
在加入频道时,可以设置Channel Mode(频道模式)为 1v1 或 Meeting 模式。他们的区别在于:
- 连接方式上有区别:1v1模式会尝试直连,也就是音视频等媒体数据在双方设备间直接传输,不经过服务器;而Meeting模式数据会经由服务器转发。
- 结束方式上有区别:1v1模式任何一方离开,则频道结束;而Meeting模式只有当所有成员全部离开后,频道才会结束。
1v1模式和Meeting模式在计费上没有区别。
Token
Token也叫安全令牌
,Token由Pano SDK使用,用于对SDK进行身份验证。SDK在与Pano Cloud交互时都需要带上Token用于身份校验。更多信息请参考权限控制。
User ID
用于唯一标识一个用户,类型为UINT64(值不能为0)。User ID由开发者传入Pano SDK(需要保证User ID的唯一性)。
号段 [0xFFFEFF0000000000, 0xFFFEFFFFFFFFFFFF] (18446461499221213184 - 18446462598732840959) 保留给 PANO 内部使用,开发者请勿使用,否则会返回错误。
User Name
表示用户名,类型为UTF-8字符串,User Name由开发者传入Pano SDK。
User ID是必填项,User Name是可选项,如果有User Name时,可读性更好。