名词说明
ERTC基本名词
本文旨在介绍您在使用萤石实时音视频 ERTC 服务过程中可能会涉及到一些基本概念。
萤石开放平台地址
萤石云平台地址，ERTC SDK使用平台地址（例如：open.ys7.com）作为萤石云接口的前缀。
RTC应用
ERTC 通过应用 的形式来管理不同的业务或项目。您可以在 开放平台控制台-云通话-实时音视频 ) 给不同的业务或项目分别创建不同的应用，从而实现业务或项目数据的隔离。每个萤石云账号最多可以创建100个 ERTC 应用。
AppID
AppID（应用标识/应用 ID）是萤石云后台用来区分不同 ERTC 应用的唯一标识，在 ERTC 控制台 创建应用时自动生成。不同 AppID 之间的数据不互通。
房间
房间是一个音视频空间，同一房间内的用户可以互相接收对方的实时音视频数据。
ERTC 使用房间这个虚拟的概念，用于用户之间的相互隔离。
只有在同一个房间里的用户才可以相互接收音视频。
同一个 UserID 同一时间只能在一个房间内，如果有相同 UserID 进入房间，前一个 UserID 将会被移出房间。
房间生命周期
第一个加入房间的用户为当前房间的所有者，但该用户无法主动解散房间。
通话模式下：所有用户都主动退房时，后台立即解散房间。
当用户要加入的房间不存在时，ERTC 后台会自动创建一个房间。
UserID
UserID（用户标识）用于在一个 ERTC 应用中唯一标识一个用户，由开发者自行指定。
用户标识是用户登录开发者业务系统的账号在萤石云上的映射。通常情况下，开发者可直接使用用户名作为 UserID。
取值范围长度建议不超过32字节。请使用英文字符、数字或下划线，不能全为数字，区分大小写。
RoomID
RoomID（房间号/房间ID）用于在一个 ERTC 应用中唯一标识一个房间。RoomID 区分数字类型（roomId）和字符串类型（strRoomId），注意 strRoomId 和 roomId 不可以混用，"123" 和 123 在 ERTC 后台服务看来并不是同一个房间。
CDN 直播观看
CDN 直播观看，又称 "CDN 旁路直播"。ERTC 在云端使用旁路转码集群，将 ERTC 所使用的 UDP 协议转换为标准的直播 RTMP 协议，把 ERTC 的音视频数据推送到标准的云直播系统中，再经由 CDN 进行分发，从而实现 CDN 直播观看。
ERTC暂未开放三方CDN直播协议，若有需求，欢迎咨询。
云端录制
ERTC 采用旁路推流的方式使用 云存储 的能力为您提供全程的云端录制功能（即录音/录像），并将录制下来的文件存储到云存储平台。
哑终端
哑终端作为观众进入房间拉流时不会被其他 SDK 感知到（远端收不到哑终端的进出房事件通知）。
资源
执行操作时的房间、被邀请的设备等等。上述访问过程中的目标对象都被抽象理解为资源。
主要用于防止终端异常操作，影响到其他未被授权的房间或会议
通话Token（偶有文档或称资源token，功能一致，场景不同叫法不同）
这是用于终端访问萤石开放平台接口的授权令牌。为了避免终端使用accessToken（大B token）访问开放平台时可能产生的越权安全问题，我们使用了小权限token。这种token极大地限制了可访问的资源范围。在此项目中，当终端需要调用加入房间、获取RTC地址等开放平台接口时，必须持有更小权限的token。
通话Token（或称资源token）由开发者云颁发给终端使用，终端可以使用此token来访问被授权的资源。
区别：通话Token 、 资源token
由于通话Token最早开发的时候需要开发者集成Java SDK，并授权一些资源，在最初一些场景也被叫做资源token，资源token跟通话Token 两者关系相等，后续随着Java SDK过于麻烦逐渐废弃，资源token不再对外称呼。开发者在文档中可以忽略两个名词的区别，后续开放平台文档更新会统一规范使用 通话Token，防止误导开发者。
accessToken
AccessToken，即访问令牌。接口调用必备的公共参数之一，用于校验接口访问/调用是否有权限，有效期为7天，有效期内不需要重复申请，可以重复使用。
有效期7天无法变更，请在业务端使用AccessToken的场景中，校验老Token的有效性和失效时重新获取Token的机制；
新获取Token不会使老Token失效，每个Token独立拥有7天生命周期
老版本在使用时会要求提供accessToken，新版本由于ak权限过大，已被资源访问token所代替
通过文档概述 · 萤石开放平台API文档获取AccessToken
取流token
这是经萤石RTC云向设备取流的授权令牌。当客户试图邀请萤石/海康设备（未接ERTC SDK）加入会议时，需调用邀请设备入会接口。该接口将通过萤石RTC云从IoT设备获取流，但在此之前，需要验证获取流的token。
可能或已经废弃的token
以下token是存在于老版本SDK中，新的SDK已经被通话Token（或称资源token）替换。请尽快进行升级。
RTC token
这是设备加入RTC房间的授权令牌。需要注意的是，在生成RTC token时，必须明确指定userId，以此标识指定终端。
萤石致力于成为全球领先的智能视觉物联网服务商，构建了全球领先的视觉物联网云平台，打造了硬件产品+软件云服务一体化的物联网服务体系。萤石云通过构建多数据中心+就近服务点的方式服务于全球客户。截至2025 年底，萤石物联网云平台在全球拥有超过120 个数据站点，平台上的IoT 设备接入数超过3.6 亿，其中视频类设备超过3 亿。在夯实自身平台能力的基础上，萤石进一步开放技术能力，将物联价值延伸至千行百业。萤石开放平台深度融合AI中台能力，涵盖音视频多媒体、消息通知处理、智能算法调度、视频存储备份、ERTC、大数据、物联接入等，已为智慧连锁、智慧养老、文教娱乐、畜牧养殖等42万余位行业客户提供数智化转型升级支撑；萤石物联专有云支持专有化部署，助力中大型企业和组织的数字化转型升级。