声网(Agora RTC)快速入门

成立于 2013 年的 声网 Agora 是实时互动 API 平台行业开创者,是全球领先的专业服务商。开发者只需简单调用 API,即可在应用内构建多种实时音视频互动场景。

Agora 互动直播(Interactive Live Streaming Premium)可以实现一对多,多对多的音视频互动直播。

应用场景

Agora 互动直播提供丰富的功能,你可以根据自己的场景需求灵活组合。

主要功能 功能描述 典型适用场景
观众连麦 观众与主播连麦聊天,观众围观。
  • 大型直播时,主播邀请观众互动
  • 狼人杀、剧本杀
  • 跨直播间连麦 多个主播跨直播间,连麦互动,观众围观。 PK 连麦
    伴奏混音 将本地或在线的音频和用户声音,同时发送并播放给频道内其他用户
  • 在线合唱
  • 针对幼儿的音乐互动课堂
  • 基础美颜 支持基础的美颜功能,包括设置美白、磨皮、祛痘、红润效果。 娱乐直播美颜
    屏幕共享 把屏幕内容同步展示给频道内的其他用户,支持指定共享某个屏幕或窗口,同时支持指定共享区域。
  • 互动课堂
  • 游戏主播展示游戏实战
  • 修改音视频原始数据 可支持变声,支持获取媒体引擎的原始语音或视频数据,对原始数据进行处理
  • 语音聊天室变声
  • 娱乐直播美颜
  • 在线媒体流输入 可以将媒体流作为一个发送端接入正在进行的直播房间。通过将正在播放的音视频添加到直播中,主播和观众可以在一起收听/观看媒体流的同时,实时互动。 可以对输入源的视频属性进行设置。
  • 主播和观众一起看电影
  • 主播和观众一起看比赛
  • 自定义视频源和渲染器 支持自定义的视频源和渲染器,可以不使用系统摄像头,使用自己构建的摄像头视频源,屏幕共享视频源,或者文件视频源等,可以更灵活地处理视频,比如添加美颜效果、滤镜等。
  • 需要使用自定义的美颜库或者前处理库
  • 开发者 App 中已经有自己的图像视频模块
  • 开发者希望使用非摄像头的视频源,比如录屏数据
  • 有些系统独占的视频采集设备,为了避免与其他业务冲突,需要灵活的设备管理策略。
  • 推流到 CDN 将频道内的音视频内容通过 CDN 推送到其他 RTMP 服务器:
  • 能够随时启动或停止推流
  • 能够在不间断推流的同时增减推流地址
  • 能够调整合图布局
  • 在朋友圈、微博等推广直播内容
  • 频道人数超限时,让更多人观看直播
  • 计费

    Agora RTC 服务使用 预付费 模式,当你的服务使用超过服务商的免费部分,且账户余额不足时,会停止服务。这时候你需要在 Cocos 开发者账户中心进行 预充值。具体内容可参考 计费与充值

    Cocos 用户开通服务,并通过 Cocos 账户预付充值,即可享受优惠政策。可联系客服询问获取 折扣券,折扣券与官方优惠叠加,优惠相当于折上折。

    版本更新说明

    • 当前版本:1.3.1_3.1

      • 修改服务名称,从 Agora Voice 改为 Agora RTC。
      • 新增视频模块,优化性能。
    • v1.2.1_3.1.2

      • 适配 Cocos Creator 2.4.x。
    • v1.1.0_2.2.3.20_2.5.2

      • 适配 Cocos Creator 2.3.x。
    • v1.0.2_2.2.3.20_2.5.2

      • Bug 修复。
    • v1.0.1_2.2.3.20_2.5.2

      • 新增 Agora service 插件。

    一键接入 Agora RTC 服务

    开通服务

    • 使用 Cocos Creator 打开需要接入 Agora RTC 服务的项目工程。

    • 点击菜单栏的 面板 -> 服务,打开 服务 面板,选择 Agora RTC,进入服务详情页。然后点击右上方的 启用 按钮即可开通服务。详情可参考 服务面板操作指南

    开通服务后,Cocos Service 将自动开通 Agora RTC 服务、联通 Agora 账号,并集成 Agora SDK 和所需预览插件到游戏工程中。

    验证服务是否接入成功

    Agora RTC 服务接入完成后,我们可以通过在脚本中添加简单的代码,来验证接入是否成功。

    • 点击 Agora RTC 服务面板中的 前往控制台 按钮跳转到 Agora 管理后台,点击左侧导航栏的 图标进入项目管理页面,获取对应游戏的 App ID

    • 在脚本中调用初始化方法,填入从 Agora 后台获取的 App ID:

        var appid = '从 Agora 后台获取的 App ID';
        agora && agora.init(appid);
      
    • 脚本修改完成并保存后,回到编辑器。在编辑器上方选择 浏览器,然后点击 预览 按钮,若能在浏览器控制台中看到初始化日志,即为接入成功。

    Sample 工程

    开发指南

    请参考 实现音频直播实现视频直播实现视频通话

    相关参考链接

    API 文档

    详细的功能接口和 API 说明,请参考 Cocos Creator SDK API Reference

    results matching ""

      No results matching ""