Skip to content

Latest commit

 

History

History

voice

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
common
common
 
 
src/main
src/main
 
 
.gitignore
.gitignore
 
 
README.md
README.md
 
 
build.gradle
build.gradle
 
 
consumer-rules.pro
consumer-rules.pro
 
 
proguard-rules.pro
proguard-rules.pro
 
 

README.md

语聊房-Android

本文档主要介绍如何快速跑通 语聊房 示例工程

Demo 效果:

1. 环境准备

  • 最低兼容 Android 7.0（SDK API Level 24）
  • Android Studio 4.0及以上版本。
  • Android 7.0 及以上的手机设备。

2. 运行示例

获取声网App ID 和 App 证书

声网Agora - 文档中心 - 如何获取 App ID
声网Agora - 文档中心 - 获取 App 证书

  • 点击创建应用

    图片

  • 选择你要创建的应用类型

    图片

  • 得到App ID与App 证书

    图片

  • 在项目的功能配置中启用"实时消息 RTM"功能, 同时启用下列子模块

    • 状态同步（Storage） 配置
    • 分布式锁（Lock ）配置
    注: 如果没有启动"实时消息 RTM"功能, 将无法体验项目完整功能

    图片

获取环信的App Key

环信

  • 创建应用

    图片

  • 查看应用的App Key

    图片

  • 在项目的gradle.properties里填写需要的声网 App ID 和 环信的 App Key

    图片

AGORA_APP_ID= （从声网console获取）
AGORA_APP_CERTIFICATE=（从声网console获取）
  
IM_APP_KEY= （从环信IM Console获取）
IM_APP_CLIENT_ID= （从环信IM Console获取）
IM_APP_CLIENT_SECRET= （从环信IM Console获取）
  • 用 Android Studio 运行项目即可开始您的体验

3.项目介绍

3.1 概述

项目名称：声动语聊 声动语聊项目是声网语聊房场景的开源代码，开发者可以获取并添加到您的APP工程里，本源码会伴随声动语聊Demo同步更新，为了获取更多新的功能和更佳的音效，强烈推荐您下载最新代码集成。

3.2 使用场景

声网声动语聊源码，最终目的是方便开发者快速按需集成，减少开发者搭建语聊房的工作量。在现有源码的基础上，您可以按需自由定制，包括UI/UE，前端逻辑，权限体系等。

3.3 功能介绍

相关类restApi网络请求交互

  • 房间管理以及对语聊房内的基本交互请求和响应，例如麦位的变化、消息的变化、礼物收发、定向消息转发、成员变化等，通过VoiceServiceProtocol来定义协议，通过VoiceSyncManagerServiceImp来实现，您可以通过自己实现的其他ServiceImp来一键替换，无需改动业务代码。

声动语聊目前已涵盖以下功能，您可以参考注释按需从代码中调用：

  • 房间管理：房间列表管理，创建房间：
  • 席位管理：踢人，麦位静音，麦位锁定：
    • 麦位管理相关功能主要依托于组件Room2DMicLayout
    • 管理房间头部以及麦位置数据变化代理，支持麦位的上下麦，换麦，静音/解除静音，锁麦/解锁，麦位的单个刷新，音量更新等麦位功能参考：RoomObservableViewDelegate
  • 互动：弹幕，打赏：
  • 音效：声网最佳音效，AI降噪：

3.4 重要类介绍

AgoraRtc管理类：AgoraRtcEngineController

IM 配置管理类(主要包括初始化IM SDK 设置回调监听)：ChatroomConfigManager

自定义消息帮助类（主要用来发送自定义消息 解析自定义消息需要的属性)CustomMsgHelper

IM管理类（包含加入房间、登录、退出登录等）ChatroomIMManager

4. FAQ

  • 如何获取声网和环信APP ID：
  • 语聊房中的弹幕组件使用的是哪家？是否可以自己选择供应商？ 声动语聊源码使用的是环信AgoraChat的IM和信令服务，您也可以使用自己的服务
  • 想体验更多场景
  • 集成遇到困难，该如何联系声网获取协助

    • 方案1：如果您已经在使用声网服务或者在对接中，可以直接联系对接的销售或服务

    • 方案2：发送邮件给 [email protected] 咨询

    • 方案3：扫码加入我们的微信交流群提问