接入流程
本文介绍实时音视频云的接入流程。
注册七牛开发者平台
若已经注册七牛开发者平台,则直接跳过此步骤。 (1)访问七牛官网,点击右上角的 登录,进入七牛开发者平台; (2)输入账号登录七牛开发者平台,若尚未注册,单击注册,进行七牛帐号注册。
选择个人或企业继续进行注册。按步骤引导填写相关信息,完成注册。
实名验证
若已经完成实名验证,则直接跳过此步骤。 注册完成后,登陆七牛开发者平台,上方会提示需要进行实名验证,请按照指引完成实名验证过程,否则无法开通实时音视频云试用账号。
开通内测账号
目前为产品灰度测试期,请直接点击 https://portal.qiniu.com/rtn/app ,登陆已经实名验证过的开发者账号即可。
应用的创建和管理
准备就绪后,下一步是为您的应用创建一个 AppID, AppID 是您应用的唯一标识,再后续的房间管理操作、鉴权操作中都需要使用。
应用的概念是您在七牛云实时音视频应用中的一个业务上的划分方式,直观的来讲就是一个 APP。同一个 APP 无需重复创建应用,同一个 APP 的不同平台(iOS、Android、Windows、Web)只需要共享一个应用即可,不同应用之间的房间无法互通。
应用的创建和管理提供两种操作方式:
- 在 Portal 的用户界面中创建, 以下描述如何使用 Portal 进行应用的创建和管理。
- 使用服务端 API 创建, 详见服务端 API 开发手册中关于 app 的操作接口。
应用创建
点击“应用创建”,按要求填写相关信息。
关联直播空间:如果需要进行旁路直播,即将互动音视频合流后再进行推流,则需要进行直播空间的绑定,否则创建时可以暂时不填,后续可以修改增加。
禁止自动踢人:默认关闭,当 2 个端以相同用户名先后加入一个房间,先加入房间的人会被后加入房间的同名用户踢走。如果打开,后加入房间的用户会被服务端拒绝,无法加入房间。
完成应用创建以后,系统会自动生成一个唯一的应用标示(AppID);请记录该 AppID,在后续的房间管理、HTTP 鉴权以及客户端请求 Room Token 等环节均需要使用。
编辑应用
左侧列表可以看到所有新建好的应用,点击具体某个应用 ID 可以查看详细的应用信息。 在应用信息详情页面,点击 “编辑应用” 按钮可以进行应用信息的修改。
编辑应用阶段,除了应用 ID 以外的其他信息均可以进行修改。
除了创建阶段填写的信息以外,如果还可以对“连麦合流转推 RTMP”进行配置。即如果您需要将合流完成的视频进行旁路直播,则需要配置此项。这里针对该项配置给出更具体的说明。
- 是否启用旁路直播:如果需要开启旁路直播,则选择“启用”
- 只合成音频:如果旁路直播只需要进行合成音频,则选择“是”
- 合流输出尺寸:输入合流最终生成尺寸的宽、高
- 合流输出帧率、码率:输入合流最终生成尺寸的帧率、码率
- 转推方式:输入指定 streamTitle 推流至连麦应用所绑定的七牛直播空间。
房间的创建和管理
所有音视频互动场景都有“房间”的概念,通俗的来讲,房间就是音视频对话发生的地方;多个用户需要相互沟通必须要找到一个地方进行交换数据,这个地方就是抽象之后就是“房间”。和现实中的房间相同,音视频互动的房间用于隔离不同的通话过程,保障数据的安全及独立。
房间无需主动创建或删除,用户直接使用客户端 sdk 指定某个 app 和 room 进行实时音视频对话即可加入房间。通过接口可以查询 app 下所有的活跃房间,也可以对某一个房间做相关的业务操作。
关于房间的创建和管理,详见服务端开发中关于 room 的操作接口描述。
我们在 Portal 中也提供可以生成 RoomToken 的工具。但需要注意到是,这里生成的 RoomToken 仅可以帮助您在初期进行开发测试,并不能替代您的 APP 服务器的角色,操作方法如下:
点击左侧应用列表,选择您的 AppID,在界面下方有如下选项:
填写房间名、用户 ID、Token 类型以及失效时间。 Token 类型分为普通用户和管理员用户,管理员用户可以进行踢人操作,普通用户不具备该权限。
SDK
七牛提供多平台的客户端 SDK 、多语言的服务端的 SDK 及 API,在您尝试接入之前,请下载您需要的客户端或服务端 SDK。我们同时提供一套 Demo 源代码,帮助您缩短开发路径。