Agora 在 GitHub 上提供开源的在线 K 歌房示例项目 Online KTV。本文介绍如何快速跑通该示例项目,体验 Agora 在线 K 歌房。
开始前,请确保你的开发环境满足以下条件:
Agora 提供的在线 K 歌房示例项目使用了第三方云服务,因此你还需要获取该云服务的有关信息。具体步骤如下:
前往第三方云服务控制台注册账号,创建一个新的应用。
应用创建成功后,点击左侧菜单栏的 设置 > 应用凭证,你可以点击右侧的复制按钮获取该应用的 AppID、AppKey 和 REST API 服务器地址。
点击 设置 > 数据存储 > 服务设置,勾选启用 LiveQuery。
在终端中运行以下命令:
pip install leancloud
// 或者
pip3 install leancloud
按照以下步骤配置示例项目:
克隆 Online-KTV 示例项目到本地,进入 Agora-Online-KTV-Android
文件夹。
打开 Agora-Online-KTV-Android/data/src/main/res/values
路径下的 strings_config.xml
文件,修改以下信息:
app_id
" 替换为在 Agora 控制台获取的 Agora App ID,将 "token
" 替换为在 Agora 控制台获取的临时 Token。leancloud_app_id
"、"leancloud_app_key
"、"leancloud_server_url
" 分别替换为在第 1 步获取的 AppID、AppKey、REST API 服务器地址。打开 Online-KTV 文件夹下的 LeanCloudHelp.py
文件,将第 1 步获取的 AppID 和 AppKey 分别填入 appid
和 appkey
。
Agora 内容中心提供在线 K 歌房场景所需歌曲及歌曲配套信息,请按照如下步骤开通内容中心,并将内容中心集成到示例项目中:
将内容中心的歌曲数据导入至第三方云数据库。
打开 Android Studio 的终端,运行以下命令:
python ./LeanCloudHelp.py
// 或者
python3 ./LeanCloudHelp.py
部署第三方云函数,更多信息请参考第三方云服务命令行参考文档。
打开第三方云服务的命令行工具,进入 Online-KTV/Backend/testproject
目录下,运行如下命令:
lean login // 登录云服务
lean switch --region REGION --group GROUP_NAME APP_ID // 切换到你的云服务项目
lean deploy --prod 1 // 部署云函数
按照以下步骤运行示例项目,体验在线 K 歌房: