本章内容出自《15分钟打造你自己的小程序》电子书,点击下载完整版
教你开发获取运动步数小程序
本教程介绍如何使用小程序Serverless服务开发一个支付宝运动小程序。借助运动数据功能,小程序在获得用户许可的情况下,可以获取用户最近30天内的运动步数,步数信息会在用户进入小程序时更新。
说明:本场景的小程序Demo需要使用蚂蚁金服开放平台企业账号。单击这里进行申请。
步骤一:签约支付宝开放能力
参考以下步骤,在蚂蚁金服开放平台签约运动数据能力:
- 使用支付宝开发者账号登录蚂蚁金服开放平台开发中心。
- 在左侧导航栏单击开发管理。
- 在小程序详情开发管理页面的能力列表中,单击右上角添加能力按钮,添加运动数据能力。
运动数据能力需要签约才能生效,在小程序上线后,单击功能列表右侧立即签约。签约完成后,需要1个工作日左右的审批时间(审批结果会以短信和邮件形式告知),审批成功后,功能状态会变为已生效。
步骤二:开发支付宝小程序
请参考以下步骤,开发支付宝小程序项目:
- 打开小程序开发者工具。
- 在左侧导航栏选择支付宝 > 小程序。
- 单击模板选取,然后单击全部页签,选择运动步数并单击下一步。
- 设置项目名称和路径,然后单击完成。
- 打开手机支付宝App扫描弹出的登录二维码。登录后,选择已创建的支付宝小程序应用完成关联,然后单击确定。
- 当提示绑定阿里云账号时,单击前往绑定阿里云账号,然后在打开的验证页面选择一种账号验证方式并完成验证。或右键单击左侧的server|未关联目录,然后选择关联Serverless。
说明:确保您要绑定的阿里云账号已关联支付宝账号。如果尚未关联,在阿里云账号页面,单击第三方账号绑定绑定支付宝。
-
在项目文件列表中找到app.js文件,配置以下信息,然后保存。
- appId是小程序的ID。您可以在蚂蚁金服开放平台的支付宝小程序页面查看App ID。
- spaceId、clientSecret和endpoint在小程序Serverless控制台创建服务空间后可以获得。
- 修改server/functions/stepdecryption/index.js文件下的 aesSecret。
-
选中server/functions/stepdecryption目录的代码作为云函数进行上传和部署 。
-
- 右键单击functions目录,选择新建云函数,输入stepdecryption回车。
-
- 右键单击stepdecryption,选择部署云函数。
-
步骤三:调试小程序
打开小程序模拟器,在弹出的服务授权框中仔细阅读《用户授权协议》后选择同意。
小程序Serverless代码详解
- 初始化
在使用小程序Serverless服务前,需要您在小程序中安装小程序Serverless客户端SDK并初始化。小程序Serverless客户端SDK的更多信息请参见安装客户端SDK2.2版本。
//client/app.js
import MPServerless from '@alicloud/mpserverless-sdk';
const mpserverless = new MPServerless({
uploadFile: my.uploadFile,
request: my.request,
getAuthCode: my.getAuthCode,
}, {
appId: ' ', // 小程序应用标识
spaceId: ' ', // 服务空间标识
clientSecret: ' ', // 服务空间 secret key
endpoint: ' ' // 服务空间地址,从小程序Serverless控制台处获得
});
- 全局使用mpserverless和授权
在调用小程序Serverless服务前,需要先调用authorize接口请求授权,支付宝小程序的授权请求参数authProvider应为alipay_openapi, 更多信息请参见authorize。
以下代码将实例化的mpserverless对象放入全局对象中以便全局使用,并在第一次打开小程序时进行服务授权。
//client/app.js
App({
mpserverless,
async onLaunch(options) {
// 第一次打开
await mpserverless.user.authorize({
authProvider: 'alipay_openapi',
// authType: 'anonymous'
})
},
});
- 获取步数的加密数据
以下代码调用了my.getRunData支付宝开放能力API,获取用户最近30天内的运动步数,更多信息请参见my.getRunData。
await my.getRunData({
countDate: `${date.getFullYear()}-${month}-${day}`,
success: (res) => {
console.log(res.response)
},
fail: (res) => {
},
complete: (res) => {
},
});
- 调用Serverless云函数传入相关参数进行解密
以下代码调用了云函数stepdecryption将my.getRunData接口的返回结果进行解密。
mpserverless.function.invoke('stepdecryption', {
"step": res.response,
})
- 云函数解密代码
以下为云函数stepdecryption代码,先将密文进行base64解码,然后使用aes-128-cbc算法解密,得到解密后的utf8明文。
'use strict';
const crypto = require('crypto');
const aesSecret = ''; // AES密钥
module.exports = async (ctx) => {
const step = ctx.args.step;
if (!step) {
return {
success: false,
error: {
code: 'InvalidParameter',
message: '待解密部署不能为空'
}
}
}
try {
ctx.logger.info('[args]', ctx.args);
const crypted = Buffer.from(step, 'base64').toString('binary');
const key = Buffer.from(aesSecret, 'base64');
const iv = Buffer.alloc(16, 0);
const decipher = crypto.createDecipheriv('aes-128-cbc', key, iv);
let decoded = decipher.update(crypted, 'binary', 'utf8');
decoded += decipher.final('utf8');
return {
success: true,
data: decoded
}
} catch (e) {
ctx.logger.error(e);
return {
success: false,
error: {
code: 'DecipheStepFail',
message: e.message
}
}
}
}