关于音视频:如何轻松实现在线-K-歌房与王心凌合唱山海

王心凌与谭维维独唱《山海》

“他明确，他明确，我给不起，于是转身向山里走去。”

《浪姐 3》二公舞台王心凌和谭维维独唱的《山海》燃炸全场，引得屏幕前的粉丝也跟着王心凌一起飙低音。

如果能开发一个在线 K 歌利用，就能与王心凌线上独唱实现追星自在。

如何疾速实现独唱性能？即构科技提供了实时独唱一站式解决方案和技术实现流程。

目前行业内广泛采纳的独唱计划为“串行独唱”。在“串行独唱”计划中，独唱各方串行退出，伴奏由主唱端混入。从实质上来说，这是一种“伪实时独唱”。

·主唱体验缺失 : 副唱、听众独唱同步成果良好，但主唱无奈实时听到副唱的歌声

· 独唱人数有限度 : 三人或以上的独唱实现简单，提早高，难以真正落地

为了冲破这两个限度，同时不影响副唱和听众端的体验，即构对计划架构进行了重构，克服了多个技术挑战，实现了独唱者之间的实时互动，也满足了三人及以上的独唱需要。

本文将分享如何基于 ZEGO SDK 轻松实现在线 K 歌房，适宜想极速搭建在线 K 歌房的开发者。也适宜想清晰听到王心凌歌声的男粉们。近期即构七周年庆全线产品 1 折起，有须要的开发者可点击详情理解：https://www.zego.im/activity/2100005

在线 K 歌技术计划

通过 ZEGO Express SDK，可极速搭建含 正版曲库 的在线 KTV 场景：

在线 K 歌场景下实时独唱计划

针对实时独唱的场景，ZEGO 提供了一站式解决方案，让开发者极速搭建可能真正进行“独唱”的在线 K 歌房。

各端在连麦的根底上同时播放歌曲伴奏，而后上麦进行独唱，双人模式下主唱和副唱能够相互听到对方声音，多人模式下独唱者之间都能听到彼此声音，简直感触不到提早，达到了真正意义上的实时独唱。

在媒体流方面，独唱者相互进行推拉流，同时会由一名独唱者推出歌曲伴奏，其余独唱者在本地播放伴奏，通过 NTP 进行工夫同步。另外，歌曲伴奏和所有独唱者的声音都通过 ZEGO RTC 进行混流服务解决造成一条流，观众只需拉一条流即可听到各端同步的声音，完满实现多人独唱的成果。

该计划的长处在于：

• 升高了端到端的时延。
• 提供了用户中途退出独唱的解决方案。
• 精准同步不同端之间的伴奏、歌词、人声。
• 改善各端设施性能和本地工夫不精准的状况，升高网络环境造成的时延影响。

实时独唱计划技术实现流程

1 概述

搭建一个残缺的在线 KTV 须要实时语音（RTC）、点歌（歌曲的获取与分享）、歌词展现等根底能力，并通过以上根底能力实现独唱、麦位治理、房间治理、歌词展现与同步等业务零碎。

2 根本流程介绍

以下介绍实现一个残缺在线 KTV 的根本流程，可帮忙您从整体上了解在线 KTV 的外围业务。

2.1 根底业务模块

在线 KTV 整体计划蕴含房间治理、麦位治理、点歌零碎、独唱同步治理、歌词同步治理 5 个业务模块，根本业务流程如下：

在线 K 歌房内的用户有多种角色，包含房主、独唱者、观众。

不同角色在本计划中的根本实现流程如下：

房主

1. 房主创立并退出房间。
2. 发动混流工作（包含房主的人声流、房主伴奏流以及所有独唱者的人声流）。
3. 通过发送 SEI 信息同步房间内所有人的歌曲播放进度。
4. 房主退出房间，房间内所有成员主动退房。
   房主创立及来到 RTC 房间，均需由业务服务器创立房间获取对应的 roomID 和 userID 后，而后通过调用 Express 接口 loginRoom 登录房间和 logoutRoom 接口退出房间。

房主通过调用 Express 相干接口进行点歌、下载歌曲和歌词、播放歌曲和发送 SEI 信息等操作，两头则由业务服务器监听房间内歌曲、麦位的信息变更，并告诉房间内所有成员。歌词下载结束后，通过歌词 UI 组件进行逐行或者逐字歌词的展现。

独唱者

1. 观众获取房间列表并退出房间后，上麦成为独唱者。
2. 推送本人的人声流，拉取所有独唱者的人声流，但不拉取混流。
3. 接管并解析房主发送的 SEI 信息，校准本端播放器进度和歌词。
   观众退出 RTC 房间上麦成为独唱者，通过获取由业务服务器创立房间对应的 roomID 和 userID 后，而后通过调用 Express 接口 loginRoom 登录房间。

独唱者通过调用 Express 相干接口下载歌曲和歌词、播放歌曲、接管和解析房主发送的 SEI 信息、同步伴奏 / 歌词等操作，两头则由业务服务器监听房间内歌曲、麦位的信息变更，并告诉房间内所有成员。歌词下载结束后，通过歌词 UI 组件进行逐行或者逐字歌词的展现。

观众

1. 观众获取房间列表并退出房间。
2. 监听房间歌曲变动，并加载歌词。
3. 拉取房主发送的混流。
4. 解析房主发送的 SEI 信息同步歌词。
   观众退出 RTC 房间，通过获取由业务服务器创立房间对应的 roomID 和 userID 后，而后通过调用 Express 接口 loginRoom 登录房间。

观众通过调用 Express 相干接口下载歌词、拉取混流、接管和解析房主发送的 SEI 信息等操作，两头则由业务服务器监听房间内歌曲、麦位的信息变更，并告诉房间内所有成员。歌词下载结束后，通过歌词 UI 组件进行逐行或者逐字歌词的展现。

3.2 重要业务模块

以下对房间治理、点歌（获取与分享歌曲）、独唱、歌词展现四个重要模块进行简略介绍。

房间治理

在线 KTV 中，个别不同的用户会在一个房间内进行 K 歌，并且还提供了一个以后的房间列表，这两局部独特形成了咱们的房间管理系统，咱们需搭配业务服务器和 Express SDK 来实现这个性能。

房主需在业务服务器创立房间获取对应的 roomID 和 userID 后，再创立 RTC 房间，而后通过调用 Express 接口 loginRoom 登录房间和 logoutRoom 接口退出房间。

API 调用时序可参考下图：

点歌（获取与分享歌曲）

点歌零碎是在线 KTV 中要害局部，应用 Express SDK 提供的点歌能力，通过获取正版曲库中的音乐资源，并分享给房间内的其余用户进行独唱。详情请参考 点歌（获取和分享歌曲）。

点歌操作能够在榜单列表或者歌曲搜寻后果进行。所点的歌曲将会进入已点队列，依照点歌工夫逐首顺次播放。

点歌人应用 songID 申请歌曲资源会触发一次计费，房间内其余人应用 token 申请歌曲资源则不会触发计费。

API 调用时序可参考下图：

独唱

在线 KTV 房间中的用户在独唱的过程中，人声和伴奏都要放弃多端同步。

• 对于独唱者而言，歌曲的各端同步次要通过 SEI 音讯实现。SEI 携带以后播放歌曲的 songID 以及歌曲播放进度 progress 等，用于多端同步播放的信息。SEI 的发送工夫距离能够与播放器进度回调的工夫距离保持一致。
• 对于观众而言，歌曲和人声的同步通过 Express SDK 提供的精准混流性能实现。

流治理是多人实时独唱中十分重要的一部分。房主、独唱者、观众的推拉流策略须要互相配合以达到较好的独唱成果。

通过 Express SDK 的精准网络工夫获取接口，以及麦上其余独唱者约定独唱的准确工夫，来进行播放伴奏和独唱，达到各独唱者之间的高度同步。详情请参考 独唱同步实现流程。

API 调用时序可参考下图：

独唱

• 流治理

• 歌词展现

咱们提供了开箱即用的歌词 UI 组件，开发者可与 Express SDK（含版权音乐性能）搭配应用，疾速展现歌词成果。详情可参考 歌词展现与同步。

集成 ZEGO SDK

1 筹备环境

在开始集成 ZEGO Express SDK 前，请确保开发环境满足以下要求：

• Android Studio 2020.3.1 或以上版本。
  Android Studio 版本编号零碎的变更请参考 Android Studio 版本阐明。
• Android SDK 25、Android SDK Build-Tools 25.0.2、Android SDK Platform-Tools 25.x.x 或以上版本。
• Android 4.4 或以上版本，且反对音视频的 Android 设施。

• Android 设施曾经连贯到 Internet。

  2 我的项目筹备

2.1 创立我的项目

进入即构官网，在【ZEGO 控制台】创立我的项目，并申请无效的 AppID，这一步很要害，appid 为利用的惟一标识，如身份证号，是利用的身份证明，用于明确你的我的项目及组织身份。zego 提供的服务也是基于 APP ID；

App ID 的获取形式很简略，只需 3～5 分钟，在即构官网 - 我的我的项目 - 创立即可。创立的我的项目信息可用于 SDK 的集成和配置；

2.2 Token 鉴权

• 登录房间时必须 应用 Token 鉴权，可参考 Token 鉴权教程

• 为了不便开发阶段的调试，开发者可间接在 ZEGO 控制台获取长期 Token（有效期为 24 小时）来应用，详情请参考 控制台（新版）– 项目管理 中的“我的项目信息”。

  3 集成 SDK

3.1 我的项目设置

开始集成前，可参考如下步骤设置你的我的项目；

如已有我的项目，本步骤可疏忽。

如需新建我的项目，可依照以下步骤创立你的新我的项目：

1. 关上 Android Studio，抉择“File > New > New Project”菜单。

2. 填写我的项目名及我的项目存储门路。

3. 其它依照默认设置，单击“Next”，最初单击“Finish”实现新工程创立。

3.2 导入 SDK

目前反对的平台架构包含：armeabi-v7a、arm64-v8a、x86、x86_64。

在实现根本的实时音视频性能之前，需确保获取的 sdk 为最新版本，保障音视频性能体验为最优；

• 应用 JitPack 主动集成 SDK
  进入我的项目根目录，关上“build.gradle”文件，在“allprojects”中退出如下代码。

...
allprojects {
    repositories {maven { url 'https://www.jitpack.io'}
        google()
        jcenter()}
}

进入“app”目录，关上“build.gradle”文件，在“dependencies”中增加 implementation 'com.github.zegolibrary:express-video:2.+'，这样能获取到最新的版本，如果须要下载指定版本，请从 https://jitpack.io/#zegolibrary/express-video 查问具体版本号，并将 2.+ 批改为指定的版本号。

...
dependencies {
    ...
    implementation 'com.github.zegolibrary:express-video:2.+'
}

1. 从 **2.7.0** 版本开始，Zego 将应用 JitPack 代替 JCenter 作为 SDK 托管服务器，因而开发者需手动将 `build.gradle` 里的配置变更为 `'com.github.zegolibrary:express-video:2.+'`
2. JCenter **2021-03-31** 之后进行上传新版本 SDK，该服务将于 **2021-05-01 停用 **，详情请参考 [Service End for JCenter](https://jfrog.com/blog/into-the-sunset-bintray-jcenter-gocenter-and-chartcenter/)。3. 从 **1.11.0** 版本开始，依赖的命令从 `implementation 'im.zego:express-engine-video:x.y.z'` 改为 `implementation 'im.zego:express-video:x.y.z'`。应用 **1.11.0 以下 ** 的版本不受影响，但后续不再从“express-engine-video”里更新，倡议所有应用旧版本的开发者切换到 **1.11.0 或以上 ** 的版本进行集成。

4 设置权限

以上步骤集成已实现，为保障 SDK 运行成果更佳，须要在利用中设置所需的权限，步骤如下：

进入“app/src/main”目录，关上“AndroidManifest.xml”文件，增加权限。

<!-- SDK 必须应用的权限 -->
<uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

<!-- App 须要应用的局部权限 -->
<uses-permission android:name="android.permission.READ_PHONE_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />

<uses-feature
    android:glEsVersion="0x00020000"
    android:required="true" />

<uses-feature android:name="android.hardware.camera" />
<uses-feature android:name="android.hardware.camera.autofocus" />

因为 Android 6.0 在一些比拟重要的权限上要求必须申请动静权限，不能只通过“AndroidMainfest.xml”文件申请动态权限。因而还须要参考执行如下代码，其中“requestPermissions”是“Activity”的办法。

String[] permissionNeeded = {
    "android.permission.CAMERA",
    "android.permission.RECORD_AUDIO"};

if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {if (ContextCompat.checkSelfPermission(this, "android.permission.CAMERA") != PackageManager.PERMISSION_GRANTED ||
        ContextCompat.checkSelfPermission(this, "android.permission.RECORD_AUDIO") != PackageManager.PERMISSION_GRANTED) {requestPermissions(permissionNeeded, 101);
    }
}

具体的权限阐明如下：

其中非必要权限“android.permission.READ_PHONE_STATE”仅用于实现 SDK 的打断事件处理，因而只需在 AndroidMainfest.xml 文件中进行申明即可，不须要动静申请（业务方有需要则另外解决）。

5 避免混同代码

在“proguard-rules.pro”文件中，为 SDK 增加 -keep 类的配置，避免混同 SDK 公共类名称。

1
-keep class **.zego.**{*;}

与王心凌独唱在线 K 歌房实现了！！！

祝贺，王心凌在线 K 歌房实时独唱性能已实现，可下载甜心教主的热门歌曲：《爱你》《睫毛弯弯》，或者翻唱的《山海》。实现追星自在，也可与好友一起多人实时独唱畅享线上 K 歌体验。

获取更多文档、Demo、技术帮忙

• 获取 SDK 开发文档、demo，可拜访即构文档核心。
• 获取更多商务活动热门产品，可提交信息分割商务。
• 注册即构 ZEGO 开发者帐号，疾速开始。