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

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

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

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

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

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

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

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

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

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

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

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

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

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

该计划的长处在于：

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

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

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

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

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

角色	形容
房主	创立 KTV 房间并推送人声、伴奏到远端，并发动混流工作。房主会主动上麦并固定为麦上首位。
独唱者	独唱者能够点歌，或者与其余独唱者进行独唱。
观众	进入 KTV 房间后，拉取播放房间内的混流。

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

房主

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

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

独唱者

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

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

观众

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

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

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

房间治理

在线 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 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 我的项目筹备

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

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

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

3 集成 SDK

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

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

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

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

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

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

目前反对的平台架构包含：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 或以上 ** 的版本进行集成。

以上步骤集成已实现，为保障 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);
    }
}

具体的权限阐明如下：

必要性	权限	权限阐明	申请起因
必要权限	INTERNET	拜访网络权限。	SDK 基本功能都须要在联网的状况下才能够应用。
	ACCESS_WIFI_STATE	获取以后 WiFi 状态权限。	SDK 会依据网络状态的扭转执行不同的操作。例如当网络重连的时候，SDK 外部会将网络断开时的状态都复原，用户不需做额定的操作。
	ACCESS_NETWORK_STATE	获取以后网络状态权限。
	CAMERA	拜访相机权限。	预览和发送视频的时候须要应用该权限。
	RECORD_AUDIO	录制音频权限。	发送音频的时候须要应用该权限。
	BLUETOOTH	连贯蓝牙设施权限。	连贯蓝牙设施时须要应用该权限。
	MODIFY_AUDIO_SETTINGS	批改音频配置权限。	批改音频设备配置时须要应用该权限。
	WRITE_EXTERNAL_STORAGE	内置 SDK 写权限。	SDK 会将日志和相干配置文件保留在内置 SDK 内。
非必要权限	READ_PHONE_STATE	容许以只读形式拜访电话状态，包含以后的呼叫状态。	SDK 会依据以后的呼叫状态，启停音频设备。如监听到以后为呼叫状态，则 SDK 会主动停止使用音频设备，直到通话完结。

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

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

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

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

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

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

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

在线 K 歌技术计划

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

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

1 概述

2 根本流程介绍

2.1 根底业务模块

房主

独唱者

观众

3.2 重要业务模块

房间治理

点歌（获取与分享歌曲）

独唱

歌词展现

集成 ZEGO SDK

1 筹备环境

2 我的项目筹备

2.1 创立我的项目

2.2 Token 鉴权

3 集成 SDK

3.1 我的项目设置

3.2 导入 SDK

4 设置权限

5 避免混同代码

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

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