打开手机扫一扫

正式商用部署流程

前端基于uni-app开发，后端基于uniCloud开发

整个有奖猜歌游戏，有2个项目，复用同一个uniCloud空间。一个项目是App端，另一个项目是管理端。

管理端面向开发商的运营人员使用，设置游戏参数，查看玩家日志，审批提现等，admin管理后台是另外插件，另见： https://ext.dcloud.net.cn/plugin?id=4102。

准备工作

有奖猜歌游戏投入运营前，需完成如下准备工作：

首先确定App的应用名称、包名、证书，后续在各个三方服务申请时，都需要包名和证书摘要。并且注意在HBuilderX中打包时，必须使用相同的包名和证书。

应用名称在manifest里设置，注意不要包含“游戏”字样，否则上架应用商店时可能会被要求提供游戏版号。请以应用的名义上架。

微信 appid 申请步骤：https://ask.dcloud.net.cn/article/208。

iOS平台微信SDK配置通用链接：https://ask.dcloud.net.cn/article/36445。

Android平台云端打包证书使用说明：https://ask.dcloud.net.cn/article/35985

以上业务都有审核周期，请提前处理。

开通广告所需条件

  1. 开通快手广告：需要提供软著和合作授权书（授权书在uni-ad申请后台获取，需要签字盖章上传）
  2. 开通优量汇广告：需要上架应用商店和软著
  3. 开通穿山甲广告：需要具备公司资质，需要上架和软著
  4. 百度百青藤广告联盟：支持开屏、插屏、激励视频广告，请使用HBuilder3.4.0版本以上进行打包
  5. 华为广告联盟（Android平台）： 包括开屏、信息流、插屏、激励视频广告，请使用HBuilder3.4.0版本以上进行打包
  6. 开通sigmob：无上架要求，无需软著，仅支持激励视频。
  7. uni-ad支持微信小程序广告，在uni-ad后台可申请开通

注： Sigmob属于小型广告联盟，收益偏低。如有条件，还需开通优量汇，快手等广告渠道以便提高收益

HBuilderX3.4.0+已支持自动配置插屏广告（无需额外开发）。在应用启动或应用后台切到前台的场景时，开屏广告展示过后进入到应用内立即展示插屏广告。您可在uni-ad后台“APP增强广告开屏管理”中配置该功能开启或者关闭。

华为广告需开发者在华为应用市场上架，且华为广告目前只展示在华为手机上。华为广告的收益相对较高，但华为广告接入标准较严，如应用不符合平台接入标准会被拒审。

为了广告收益最大化，uni-ad建议您的应用至少要开通3家以上广告渠道（能多开就多开），只有开通3家以上广告渠道后优化算法才能有效启动。

有奖猜歌游戏开发完成后，需要开通广告，推荐流程为：申请软著 -> 开通快手广告 ->上架应用市场 -> 开通优量汇广告 ->若有公司资质可开通穿山甲广告。

配置参数

先部署有奖猜歌前端项目，再到有奖猜歌游戏管理后台自行配置广告位、游戏等相关参数

1. 开通uniCloud

2. manifest.json配置

完成如下配置：

3. uni-id配置

在项目目录uniCloud--> cloudfunctions--> common--> uni-config-center--> uni-id--> config.json文件里：

    "app-plus": {
        "oauth": {
            "weixin": {//app端微信登录 ，填写`appid` 、`appsecret`
                "appid": "",
                "appsecret": ""
            },
            "apple": {//苹果登录，填写包名
                "bundleId": ""
            }
        }
    },
    "mp-weixin": {
        "oauth": {
            "weixin": {//微信小程序，填写小程序appid、appsecret
                "appid": "",
                "appsecret": ""
            }
        }
    },
    "service": {
        "univerify": {//一键登录相关配置
            "appid": "",
        }
    }

4. 提现方式配置

提现方式有两种方式：支付宝个人批量转账和微信企业付款到零钱，可自行按需选择，在有奖猜歌游戏管理后台--> 提现设置 --> 提现方式配置

支付宝方式

微信方式

    {
        "app":{
            "weixin" : {
                "appid" : "wxxxxxxxxxxxxxxx",//公众号id
                "mchid" : "00000000000",//商户id
                "partnerKey" : "xxxxxxxxxxxxxxxxxxxxx"//安全密钥
            }
        }
    }

替换apiclient_cert.p12证书

微信支付接口中，涉及资金回滚的接口会使用到API证书，包括退款、撤销接口。商家在申请微信支付成功后，收到的相应邮件后，可以按照指引下载API证书，也可以按照以下路径下载：微信商户平台(pay.weixin.qq.com)-->账户中心-->账户设置-->API安全。更多内容详见

将 hallctrlsong--> controller目录下的apiclient_cert.p12和 uni-admin--> controller 目录下的apiclient_cert.p12替换成从你自己微信商户平台下载的API证书。

如果在接入过程中遇到问题参考微信付款到零钱文档中错误码排查。

教程参考，微信App支付功能申请

如果在接入过程中遇到问题参考微信付款到零钱文档中错误码排查。

5. 激励视频回调配置

激励视频广告可以支持广告服务器到业务服务器的回调，用于业务系统判断是否提供奖励给观看广告的用户。配置服务器回调后，当用户成功看完广告时，广告服务器会访问配置的云函数，通知用户完成观看激励视频。

相对来讲服务器回调将更加安全，可以依赖广告平台的反作弊机制来避免用户模拟观看广告完成的事件。详见

你需要在uni-ad系统的激励视频广告位，点击配置激励视频，出现以下界面，选择服务空间，选择激励视频回调云函数rewarded-video-callback，保存。

选择已配置好的广告位，展开可查看到Secret，如下：

在uniCloud--》cloudfunctions--》common --》uni-config-center --》uni-ad --》config.json文件配置Security key如下：


{
    "fuhuoSecuritykey":"猜歌复活奖励视频，uni-ad 后台开通激励视频回调后生成的Secret",
    "renwuSecuritykey":"做任务看视频，uni-ad 后台开通激励视频回调后生成的Secret"
}

在uni-config-center目录，右键‘上传公共模块’

6. 上传云函数和公共模块

7. 自动绑定上下级关系

通过发送携带专属邀请码的下载页给同伴或用户安装App，能够自动发展下级好友、以及绑定新用户从属关系。

  1. 在猜歌游戏前端项目--》manifest.json--》h5配置--》运行的基础路径，配置/download/，用于托管下载页面，在有奖猜歌游戏管理后台--> 参数管理 --> 下载页设置，填写分销裂变下载页域名，格式例如static-XXXXXX-XXXX.bspapp.com/download或xxx.com/download

  1. 在uniCloud--》database--》opendb-app-versions.schema.json，开启读取权限，将read：false改为 read：true ，右键'上传此DB schema'

  1. 增加应用版本名称和应用版本号信息，打包app成功后，在admin管理后台--》升级中心--》发布新版。

  2. 因浏览器跨域问题，发行H5站点时需uniCloud web控制台，跨域配置配置安全域名，允许该域名跨域访问云函数服务器。

  3. 发行分销裂变下载页：点击发行--》上传网站到服务器--》点上传（未开通前端网页托管需要点击开通托管，去uniCloud web控制台，前端网页托管--》点击开通）

注意事项

8. 隐私政策弹框

根据工业和信息化部关于开展APP侵害用户权益专项整治要求，App提交到应用市场必须满足以下条件：

配置弹出“隐私协议和政策”：在项目的manifest.json--> 源码视图--> app-plus--> privacy 节点，修改文字内容，替换服务协议和隐私政策链接。

    "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网赚游戏交流群，给我们反馈！

交流群1：645630288（已满） DCloud网赚游戏交流群

交流群2：711753236 DCloud网赚游戏2群

二次开发

如果你需要二开，改动游戏源码，或者获取本项目的图片的psd原图，则需按照以下步骤申请：

项目构成

├── 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：691878059或1418504531（添加时备注来意）。。

DCloud正在寻找更多行业服务商，开发各种基于uniCloud的项目，如论坛、阅读、短视频.... 由DCloud出资，开发完毕后上架插件市场，然后行业合作伙伴可持续接二开的项目。有意成为uniCloud行业服务商的公司或个人可以联系bd@dcloud.io 。详见

初始化歌曲库，是由大连外包公司提供给开发者测试使用，商用中如需更丰富的歌曲库，请自行获取版权歌曲，并上传admin后台。可从如下方式获取：

  1. 某宝、某度查找
  2. QQ搜索，加一些无版权音乐分享群
  3. 网站查找：全球10大免费高质量无版权音乐网站
  4. 如果有大批量的歌曲需求，建议您对接腾讯云的曲库接口: 腾讯歌曲曲库接口

初始化测试歌曲目前存在DCloud云储存下，建议将测试歌曲下载并上传到自己的云存储中，替换database---》songlist.init_data.json 中歌曲地址url

 {
     "url": "",//填写你自己的歌曲存储地址
     "daan1": "夜空中最亮的星",
     "daan2": "牧马城市",
     "daan3": "一吻天荒",
     "correct": 1,
     "createtime": 1617851118
 }

FAQ：常见问题

  1. 本项目代码可以商用，无需为DCloud付费。但您只能在DCloud产品体系内使用本软件及其源码。您不能将源码修改后运行在DCloud产品体系之外的环境，比如客户端脱离uni-app，或服务端脱离uniCloud，或脱离uni-ad。这将违反使用许可协议。
  2. 广告费用或cpm不会因为使用本项目代码而下降，本项目不扣分成。正常接入uni-ad就好。
  3. 真机调试，一键登录失败，HBuilderX控制台报错：
    [本地调试]"[hallctrlsong]返回结果：" {"code":4001,"message":"errCode: 4001 | errMsg: 获取手机号码失败：uni一键登录 apiKey 不存在"}

解决方案：选择连接云端云函数

[hallctrlsong]:4008:应用所有者账号信息异常,请检查账号uni一键登录服务是否正常 at pages/login/login.js:250

可能原因：uni-id 依赖的uni-config-center里uni-id配置是旧的。

解决方案：删除uni-id下的 node_modules

  1. 出现报错config-param-requred，检查uni-id config中填写必填项，重新上传公共模块和uni-id云函数，并更新依赖此模块的云函数

    Error:[hallctrlsong]:INVOKE_FUNCTION_FAILED:config-param-requred at pages/login/login.js:250

  2. 欢迎加入有奖猜歌游戏交流群，QQ群号：645630288，加群时请备注你的DCloudAppId，什么是DCloud appid说明。