文章目录
常见系统API
页面分享的基本介绍
分享是小程序扩散的一种重要方式,小程序中有两种分享方式:
当我们转发给好友一个小程序时,通常小程序中会显示一些信息:
属性 | 类型 | 说明 |
---|---|---|
title | string | 转发标题,不传则默认使用当前小游戏的昵称。 |
imageUrl | string | 转发显示图片的链接,可以是网络图片路径或本地图片文件路径或相对代码包根目录的图片文件路径。显示图片长宽比是 5:4 |
query | string | 查询字符串,必须是 key1=val1&key2=val2 的格式。从这条转发消息进入后,可通过 wx.getLaunchOptionsSync() 或 wx.onShow() 获取启动参数中的 query。 |
imageUrlId | string | 审核通过的图片 ID,详见使用审核通过的转发图片 |
promise | promise | 如果该参数存在,则其它的参数将会以 resolve 结果为准,如果三秒内不 resolve,分享会使用上面传入的默认参数 |
toCurrentGroup | boolean | 是否转发到当前群。该参数只对从群工具栏打开的场景下生效,默认转发到当前群,填入 false 时可转发到其他会话。 |
onShareAppMessage() {
return {
title: "我是分享的标题",
path: "/pages/index/index.js",
imageUrl: "/assets/zznh.png"
}
}
设备信息和位置信息
获取设备信息
wx.getSystemInfo({
success: (res) => {
console.log(res);
}
})
获取位置信息
wx.getLocation({
success: (res) => {
console.log(res);
}
})
成功回调res中包含下面一些信息
属性 | 类型 | 说明 |
---|---|---|
latitude | number | 纬度,范围为 -90~90,负数表示南纬 |
longitude | number | 经度,范围为 -180~180,负数表示西经 |
speed | number | 速度,单位 m/s |
accuracy | number | 位置的精确度,反应与真实位置之间的接近程度,可以理解成10即与真实位置相差10m,越小越精确 |
altitude | number | 高度,单位 m |
verticalAccuracy | number | 垂直精度,单位 m(Android 无法获取,返回 0) |
horizontalAccuracy | number | 水平精度,单位 m |
小程序Storage存储
在开发中,某些常见我们需要将一部分数据存储在本地:比如token、用户信息等。
同步存取数据的方法:
// 存入数据
wx.setStorageSync("name", "chenyq")
wx.setStorageSync("age", 18)
// 取出数据
const name = wx.getStorageSync("name")
const age = wx.getStorageSync("age")
console.log(name);
console.log(age);
// 删除数据
wx.removeStorageSync("name")
// 清空数据
wx.clearStorageSync()
异步存储数据的方法:注意传入的是对象
// 存入数据
wx.setStorage({
key: "names",
data: ["aaa", "bbb", "ccc"],
// 存入成功的回调
success: (res) => {
console.log(res);
}
})
// 取出数据
const names = wx.getStorage({
key: "names",
success: (res) => {
console.log(res.data);
}
})
// 删除数据
wx.removeStorage({
key: "names",
success: (res) => {
console.log(res);
}
})
// 清空数据
wx.clearStorage()
区别: 同步和异步的区别就是, 同步存取代码执行完成后, 可以立即获取数据, 而异步代码执行完成, 不能保证可以立即获取到数据