Uniapp有奖猜歌游戏完整版正式商用部署流程
前端基于uni-app开发，后端基于[uniCloud]开发
整个有奖猜歌游戏，有2个项目，复用同一个uniCloud空间。一个项目是App端，另一个项目是管理端。
管理端面向开发商的运营人员使用，设置游戏参数，查看玩家日志，审批提现等，admin管理后台是另外插件，另见：
https://ext.dcloud.net.cn/plugin?id=4102
一、准备工作
有奖猜歌游戏投入运营前，需完成如下准备工作：
首先确定App的应用名称、包名、证书，后续在各个三方服务申请时，都需要包名和证书摘要。并且注意在HBuilderX中打包时，必须使用相同的包名和证书。
应用名称在`manifest`里设置，注意不要包含“游戏”字样，否则上架应用商店时可能会被要求提供游戏版号。请以应用的名义上架。
- 申请软件著作权：开通广告必须要求软著。加入DCloud软著优惠加急申请QQ专用群：893532138
- 申请uniAD：开通增强广告，申请激励视频的广告位，详见[uniAD官网](https://uniad.dcloud.net.cn)
- 申请一键登录：在 manifest.json -> App模块配置 -> OAuth（登录鉴权）-> 一键登录，点击后面的`开通配置`，在打开的web页面添加应用，充值。
- 申请微信登录：在微信开放平台申请移动应用，获得的appid和appsecret，用于微信登录、微信分享。[微信开放平台](https://open.weixin.qq.com/)
> 申请要求提供应用官网，如果还是没有官网的同学，可使用**官网模板**插件：[https://ext.dcloud.net.cn/plugin?id=8935](https://ext.dcloud.net.cn/plugin?id=8935)。
- 提现方式有两种选择：微信企业付款到零钱和个人支付宝批量转账方式。**暂时无法开通微信商户支付的用户可选择个人支付宝方式转账**。选择微信提现方式，需要申请微信提现：用于将网赚激励直接打款到手机用户的微信零钱中。在微信商户平台申请，需要完成企业资质认证，在产品中心，开通企业付款到零钱功能：微信官方要求需要有90天注册时长，近30天连续业务流水，并状态良好的账号方可开通。[微信支付商户平台](https://pay.weixin.qq.com/)。
微信 appid 申请步骤：[https://ask.dcloud.net.cn/article/208](https://ask.dcloud.net.cn/article/208)。
iOS平台微信SDK配置通用链接：[https://ask.dcloud.net.cn/article/36445](https://ask.dcloud.net.cn/article/36445)。
Android平台云端打包证书使用说明：[https://ask.dcloud.net.cn/article/35985](https://ask.dcloud.net.cn/article/35985)
以上业务都有审核周期，请提前处理。
开通广告所需条件
1. 开通快手广告：需要提供软著和合作授权书（授权书在uniAD申请后台获取，需要签字盖章上传）
2. 开通优量汇广告：需要上架应用商店和软著
3. 开通穿山甲广告：需要具备公司资质，需要上架和软著
4. 百度百青藤广告联盟：支持开屏、插屏、激励视频广告，请使用HBuilder3.4.0版本以上进行打包，[开通百度广告，空包签名教程](https://ask.dcloud.net.cn/article/39710)
5. 华为广告联盟（Android平台）： 包括开屏、信息流、插屏、激励视频广告，请使用HBuilder3.4.0版本以上进行打包
6. 开通sigmob：无上架要求，无需软著，仅支持激励视频。
7. [uni-ad支持微信小程序广告](https://uniapp.dcloud.io/component/ad-weixin.html)，在uni-ad后台可申请开通
注： Sigmob属于小型广告联盟，收益偏低。如有条件，还需开通优量汇，快手等广告渠道以便提高收益
HBuilderX3.4.0+已支持自动配置插屏广告（无需额外开发）。在应用启动或应用后台切到前台的场景时，开屏广告展示过后进入到应用内立即展示插屏广告。您可在uniAD后台“APP增强广告开屏管理”中配置该功能开启或者关闭。
华为广告需开发者在华为应用市场上架，且华为广告目前只展示在华为手机上。华为广告的收益相对较高，但华为广告接入标准较严，如应用不符合平台接入标准会被拒审。
为了广告收益最大化，uniAD建议您的应用至少要开通3家以上广告渠道（能多开就多开），只有开通3家以上广告渠道后优化算法才能有效启动。
有奖猜歌游戏开发完成后，需要开通广告，推荐流程为：申请软著 -> 开通快手广告 ->上架应用市场 -> 开通优量汇广告 ->若有公司资质可开通穿山甲广告。
二配置参数
先部署有奖猜歌前端项目，再到[有奖猜歌游戏管理后台](https://ext.dcloud.net.cn/plugin?id=4825)自行配置广告位、游戏等相关参数
1. 开通uniCloud
- 开通uniCloud：本项目是云端一体的，它的云端代码需要部署在uniCloud云服务空间里，需要开通uniCloud。在[https://unicloud.dcloud.net.cn/](https://unicloud.dcloud.net.cn/)登录，按云厂商要求进行实名认证。
- 在uniCloud认证通过后，创建一个服务空间给本项目使用。选择阿里云或腾讯云均可。[参考](https://uniapp.dcloud.net.cn/uniCloud/price)
- 使用HBuilderX 3.1以上版本（最好是最新版），把本项目导入到HBuilderX中，在项目根目录uniCloud上点右键菜单，关联服务空间 -> 选择之前创建的服务空间
2. manifest.json配置
完成如下配置：
- 获取appid
- App图标配置
- App模块配置 --> OAuth（登录鉴权）勾选`一键登录`。
- App模块配置 --> OAuth（登录鉴权）--> 勾选微信登录 --> 填写`appid`、`appsecret`、`ios平台通用链接`。
- App模块配置 --> Share（分享）--> 勾选`微信分享`，填写`appid`、如需在iOS平台使用还需要配置通用链接，填写`ios平台通用链接`。
- App模块配置 --> OAuth（登录鉴权）勾选苹果登录，[IOS苹果授权登录参考文档](https://ask.dcloud.net.cn/article/36651)。如不发布到 Appstore，不需要配置此项
- App常用其他设置 --> 填写关联域 Associated Domains [参考教程](https://ask.dcloud.net.cn/article/36393)。如不发布到Appstore，不需要配置此项
- 微信小程序配置 --> 填写微信小程序AppID（请在微信开发者工具中获取）
- 源码视图中 --> `app-plus` --> `privacy` 设置`服务协议和隐私政策`弹框，将协议链接替换成你自己的。
3. uni-id配置
在项目目录`uniCloud`--> `cloudfunctions`--> `common`--> `uni-config-center`--> `uni-id`--> `config.json`文件里：
- App端的微信登录填写`app-plus` --> `oauth`--> `weixin`，填写`appid` 、`appsecret`, 在微信开放平台查看，[微信开放平台](https://open.weixin.qq.com/)
- 苹果登录需要配置，`app-plus`--> `oauth`--> `apple`，填写包名`bundleId`
- 微信小程序端登录，`mp-weixin`--> `oauth`--> `weixin`，填写微信小程序的`appid`、`appsecret`
- 一键登录填写`service` --> `univerify`，填写 `appid` 、`apiKey` 和 `apiSecret`。在[DCloud开发者中心](https://dev.dcloud.net.cn/)一键登录基础配置下可查看。
```js
"app-plus": {
"oauth": {
"weixin": {//app端微信登录 ，填写`appid` 、`appsecret`
"appid": "",
"appsecret": ""
},
"apple": {//苹果登录，填写包名
"bundleId": ""
}
}
},
"mp-weixin": {
"oauth": {
"weixin": {//微信小程序，填写小程序appid、appsecret
"appid": "",
"appsecret": ""
}
}
},
"service": {
"univerify": {//一键登录相关配置
"appid": "",
"apiKey": "",
"apiSecret": ""
}
}
```
4. 提现方式配置
提现方式有两种方式：支付宝个人批量转账和微信企业付款到零钱，可自行按需选择，在[有奖猜歌游戏管理后台](https://ext.dcloud.net.cn/plugin?id=4825)--> 提现设置 --> 提现方式配置
- zhifubao：支付宝提现方式（个人支付宝转账）
- weixin：微信提现方式（需开通微信商户支付）
- **暂时无法开通微信商户支付的用户可选择个人支付宝方式转账**
支付宝方式
- 提现要求：用户需要在app端，在设置页面完成实名认证和支付宝账号绑定
- 提现操作，详见[有奖猜歌游戏管理后台](https://ext.dcloud.net.cn/plugin?id=4825)
微信方式
- 提现要求：用户需要在app端，在设置页面完成实名认证，在提现页面绑定微信
- 确保已开通微信支付商户，企业付款到零钱功能。
- 在项目目录`uniCloud`--》 `cloudfunctions`--》 `common`--》`uni-config-center` --》 `uni-pay` --》`config.json`文件内，配置如下：
```js
{
"app":{
"weixin" : {
"appid" : "wxxxxxxxxxxxxxxx",//公众号id
"mchid" : "00000000000",//商户id
"partnerKey" : "xxxxxxxxxxxxxxxxxxxxx"//安全密钥
}
}
}
```
替换apiclient_cert.p12证书
微信支付接口中，涉及资金回滚的接口会使用到API证书，包括退款、撤销接口。商家在申请微信支付成功后，收到的相应邮件后，可以按照指引下载API证书，也可以按照以下路径下载：微信商户平台(pay.weixin.qq.com)-->账户中心-->账户设置-->API安全。[更多内容详见](https://pay.weixin.qq.com/wiki/doc/api/tools/mch_pay.php?chapter=4_3)
将 `hallctrlsong`--> `controller`目录下的`apiclient_cert.p12`和 `uni-admin`--> `controller` 目录下的`apiclient_cert.p12`替换成从你自己微信商户平台下载的API证书。
教程参考，[微信App支付功能申请](https://uniapp.dcloud.net.cn/api/plugins/payment?id=app%e5%b9%b3%e5%8f%b0%e6%94%af%e4%bb%98%e6%b5%81%e7%a8%8b)
5. 激励视频回调配置
激励视频广告可以支持广告服务器到业务服务器的回调，用于业务系统判断是否提供奖励给观看广告的用户。配置服务器回调后，当用户成功看完广告时，广告服务器会访问配置的云函数，通知用户完成观看激励视频。
相对来讲服务器回调将更加安全，可以依赖**广告平台的反作弊机制**来避免用户模拟观看广告完成的事件。[详见](https://uniapp.dcloud.io/api/a-d/rewarded-video?id=callback)
你需要在[uni-ad系统](https://uniad.dcloud.net.cn/)的激励视频广告位，点击**配置激励视频**，出现以下界面，选择服务空间，选择激励视频回调云函数`rewarded-video-callback`，保存。
选择已配置好的广告位，展开可查看到`Security key`，如下：
在`uniCloud`--》`cloudfunctions`--》`common` --》`uni-config-center` --》`uni-ad` --》`config.json`文件配置`Security key`如下：
```js
{
"fuhuoSecuritykey":"猜歌复活奖励视频，uniad 后台开通激励视频回调后生成的Security key",
"renwuSecuritykey":"做任务看视频，uniad 后台开通激励视频回调后生成的Security key"
}
```
在`uni-config-center`目录，右键‘上传公共模块’
6. 上传云函数和公共模块
在`uniCloud` -> `cloudfunctions`目录右键，选择 “上传所有云函数、公共模块及actions”。
7. 自动绑定上下级关系
通过发送携带专属邀请码的下载页给同伴或用户安装App，能够自动发展下级好友、以及绑定新用户从属关系。
1. 在猜歌游戏前端项目--》manifest.json--》h5配置--》运行的基础路径，配置`/download/`，用于托管下载页面，在[有奖猜歌游戏管理后台](https://ext.dcloud.net.cn/plugin?id=4825)--> 参数管理 --> 下载页设置，填写分销裂变下载页域名，格式例如`static-XXXXXX-XXXX.bspapp.com/download`或`xxx.com/download`
https://web-assets.dcloud.net.cn/ext/moneygame/moneygame-10.jpg
2. 在`uniCloud`--》`database`--》`opendb-app-versions.schema.json`，开启读取权限，将read：false改为 **read：true** ，右键'上传此DB schema'
3. 增加应用版本名称和应用版本号信息，打包app成功后，在admin管理后台--》升级中心--》发布新版。
4. 因浏览器跨域问题，发行H5站点时需[uniCloud web控制台](https://unicloud.dcloud.net.cn/)，`跨域配置`配置安全域名，允许该域名跨域访问云函数服务器。
5. 发行分销裂变下载页：点击`发行`--》`上传网站到服务器`--》点`上传`（未开通前端网页托管需要点击`开通托管`，去[uniCloud web控制台](https://unicloud.dcloud.net.cn/)，`前端网页托管`--》`点击开通`）
**注意事项**
本项目需要HBuilderX 3.1.22+ 以上版本
- 配置分销裂变下载页的域名：在[uniCloud web控制台](https://unicloud.dcloud.net.cn/)，`前端网页托管`--》`参数配置`，找到默认域名或者配置网站域名，用默认域名（访问次数有限制），上线**一定要配置自己购买的域名**。
8. 隐私政策弹框
根据工业和信息化部关于开展APP侵害用户权益专项整治要求，App提交到应用市场必须满足以下条件：
- 应用启动运行时需弹出隐私政策协议，说明应用采集用户数据
- 应用不能强制要求用户授予权限，即不能“不给权限不让用”
- 如不希望应用启动时申请“读写手机存储”和“访问设备信息”权限，请参考：https://ask.dcloud.net.cn/article/36549
配置弹出“隐私协议和政策”：在项目的`manifest.json`--> `源码视图`--> `app-plus`--> `privacy` 节点，修改文字内容，替换服务协议和隐私政策链接。
```js
"privacy" : {
"prompt" : "template",
"template" : {
"title" : "服务协议和隐私政策",
"message" : " 请你务必审慎阅读、充分理解“服务协议”和“隐私政策”各条款，包括但不限于：为了更好的向你提供服务，我们需要收集你的设备标识、操作日志等信息用于分析、优化应用性能。<br/> 你可阅读<a href=\"https://ask.dcloud.net.cn/protocol.html\">《服务协议》</a>和<a href=\"https://ask.dcloud.net.cn/protocol.html\">《隐私政策》</a>了解详细信息。如果你同意，请点击下面按钮开始接受我们的服务。",
"buttonAccept" : "同意",
"buttonRefuse" : "暂不同意"
}
}
```
登录页服务协议和隐私政策配置：
在项目目录 `components`--> `uni-agreements` --> `uni-agreements.vue` --> `agreements` --> `url`替换成自己的《用户服务协议》和《隐私政策》链接。
9. APP云打包
IOS和Android云打包，配置正确的包名，勾选广告，打包。
注意：打包安卓或者苹果时，需要在开发者中心后台一键登录中配置相应平台的Android 包名或IOS BundleId 。
到此为止就部署完成啦！如果您在部署过程中遇到什么问题，可加入DCloud网赚游戏交流群，给我们反馈！
二次开发
如果你需要二开，改动游戏源码，或者获取本项目的图片的psd原图，则需按照以下步骤申请：
- 在[DCloud开发者中心](https://dev.dcloud.net.cn/)，完成账号的企业实名认证。
- 使用在HBuilderX中注册的邮箱，发邮件到uniad@dcloud.io，说明企业是否有此类网赚游戏的成功案例经验做出简单介绍说明，以及公司的具体信息（包含：企业名、法人、联系方式）
项目构成
```
├── uniCloud ─────────────────────────────# 云函数目录
├──── cloudfunctions ─────────────────────# 云函数目录
│ ├── common ───────────────────────# 公共模块
│ │ └── globalunit ────────────# 业务操作公共模块
│ │ └── logic ───────# 业务logic层
│ │ └── model ───────# 数据模型
│ │ └── utils ───────# 云函数公共类库
│ ├── hallctrlsong ─────────────────────# 业务主逻辑函数
│ │ ├── controller ────────────# 控制层
│ │ │ └── hall.js ────────# 业务主逻辑函数
│ │ ├── middleware ────────────# 中间件层
│ │ │ └── auth.js ────────# 验证token等
│ │ │ └── body.js ────────# 过滤数据等
│ │ ├── node_modules ──────────# 函数依赖公共模块
│ │ └── index.js ──────────────# 函数入口文件
│ └── uni-admin ────────────────────# 管理后台主逻辑函数
│ ├── controller ────────────# 控制层
│ │ └── admin.js ───────# 业务主逻辑函数
│ ├── middleware ────────────# 中间件层
│ │ └── auth.js ────────# 验证token等
│ │ └── body.js ────────# 过滤数据等
│ ├── service ───────────────# 具体业务层
│ ├── node_modules ──────────# 函数依赖公共模块
│ └── index.js ──────────────# 函数入口文件
├──── database ───────────────────────────# 数据库集合Schema目录
│ └── db_init.json ─────────────────# 数据库初始化文件，包含数据表和初始化数据
├── common ───────────────────────────────# 前端公共类库
├── compontents ──────────────────────────# 云函数目录
│ ├── player──────────────────────────# 唱片机组件
│ └── pt-lottery──────────────────────# 大转盘组件
├── pages ────────────────────────────────# 前端页面
│ ├── about ──────────────────────────# 关于页面
│ ├── index ──────────────────────────# 首页（猜歌页面）
│ ├── login ──────────────────────────# 登录页
│ ├── mine ───────────────────────────# 我的页面
│ ├── nickname ───────────────────────# 修改昵称页面
│ ├── play ───────────────────────────# 玩法介绍页面
│ ├── renwu ──────────────────────────# 任务页面
│ ├── set ────────────────────────────# 设置页面
│ ├── shiming ────────────────────────# 实名认证页面
│ ├── tixian ─────────────────────────# 提现页面
│ └── xieyi ──────────────────────────# 协议页面
├── static ───────────────────────────────# 静态资源
├── uni_modules ──────────────────────────# uni_modules 组件目录
│ ├── uni-captcha ────────────────────# 验证码模块
│ ├── uni-cloud-router ───────────────# 云函数路由库
│ ├── uni-id ─────────────────────────# 用户中心
│ ├── uni-popup ──────────────────────# 弹出层组件
│ └── uni-transition ─────────────────# 过渡动画组件
```
## 其他说明
本项目由DCloud委托大连一家外包公司开发，该公司同时承接二开定制工作。如有二开需求，请加QQ群：711753236。
DCloud正在寻找更多行业服务商，开发各种基于uniCloud的项目，如论坛、阅读、短视频.... 由DCloud出资，开发完毕后上架插件市场，然后行业合作伙伴可持续接二开的项目。有意成为uniCloud行业服务商的公司或个人可以联系bd@dcloud.io 。[详见](https://ask.dcloud.net.cn/article/38878)
初始化歌曲库，是由大连外包公司提供给开发者测试使用，商用中如需更丰富的歌曲库，请自行获取版权歌曲，并上传admin后台。可从如下方式获取：
1. 某宝、某度查找
2. QQ搜索，加一些无版权音乐分享群
3. 网站查找：[全球10大免费高质量无版权音乐网站](https://baijiahao.baidu.com/s?id=1670258908263550190&wfr=spider&for=pc)
4. 如果有大批量的歌曲需求，建议您对接腾讯云的曲库接口: [腾讯歌曲曲库接口](https://cloud.tencent.com/product/ame?fromSource=gwzcw.3471691.3471691.3471691&utm_medium=cpc&utm_id=gwzcw.3471691.3471691.3471691)
初始化测试歌曲目前存在DCloud云储存下，建议将测试歌曲下载并上传到自己的云存储中，替换`database`---》`db_init.json` --》`songlist` --》`data` 中歌曲地址url
```html
"songlist": {
"data": [
{
"url": "",//填写你自己的歌曲存储地址
"daan1": "夜空中最亮的星",
"daan2": "牧马城市",
"daan3": "一吻天荒",
"correct": 1,
"createtime": 1617851118
}
]
}
```
## FAQ：常见问题
1. 本项目代码可以商用，无需为DCloud付费。但您只能在DCloud产品体系内使用本软件及其源码。您不能将源码修改后运行在DCloud产品体系之外的环境，比如客户端脱离uni-app，或服务端脱离uniCloud，或脱离uniAD。这将违反使用许可协议。
2. 广告费用或cpm不会因为使用本项目代码而下降，本项目不扣分成。正常接入`uni-ad`就好。
3. 真机调试，一键登录失败，HBuilderX控制台报错：
```js
[本地调试]"[hallctrlsong]返回结果：" {"code":4001,"message":"errCode: 4001 | errMsg: 获取手机号码失败：uni一键登录 apiKey 不存在"}
```
解决方案：选择**连接云端云函数**
4. 欢迎加入有奖猜歌游戏交流群，QQ群号：645630288，加群时请备注你的DCloudAppId，[什么是DCloud appid说明](https://ask.dcloud.net.cn/article/35907)。
