1.2.11 • Published 3 years ago
sapp-js-sdk v1.2.11
JS-SDK说明文档
JSSDK使用步骤
步骤一:引入JS文件
浏览器直接引用
<script src="https://cdn.jsdelivr.net/npm/sapp-js-sdk/src/dist/sapp-js-sdk-min.js"></script>
npm 包管理工具引用
// 控制台
npm install sapp-js-sdk
// import
import sapp from 'sapp-js-sdk/src/lib/sdk'
步骤二:通过ready接口来调用
sapp.ready(() => {
// 调用sapp.util的方法
})
接口调用说明
所有接口通过sapp对象来调用,参数是一个对象,除了每个接口本身需要的参数以外,还有以下通用参数:
1.success:调用成功时执行的回调函数。
2.fail:调用失败时执行的回调函数。
基础接口
获取token
sapp.util.getAuthorization({
success: () => {
// 获取成功
},
fail: () => {
// 获取失败
}
})
登出,返回登录页面
sapp.util.logOut()
检测App版本
sapp.util.checkVersion()
刷新重新载入
sapp.util.refresh()
设备相关接口
获取设备信息
sapp.util.getSystemInfo({
success: (res) => {
const info = res.data // 获取成功
},
fail: (error) => {
// 获取失败
}
})
存储相关接口
保存数据
sapp.util.cacheSetItem({
key: '', // 保存时的key
value: '', // 保存的值
option: {
time: 10, //存储的时间 当time等于0时表示永久
type: 'M' //存储时间类型可选 'M' 'S' 'ms'
},
success: () => {
// 保存成功
},
fail: (error) => {
// 保存失败
}
})
取出数据
sapp.util.cacheGetItem({
key: '', // key
success: (res) => {
const data = res.data // 获取成功
},
fail: (error) => {
// 获取失败
}
})
清空数据
sapp.util.cacheClear({
success: () => {
// 清空完成
},
fail: (error) => {
// 清空失败
}
})
位置接口
获取地理位置
sapp.util.getLocation({
success: (res) => {
const address = res.data // 获取成功
},
fail: (error) => {
// 获取失败
}
})
图像接口
拍照或从手机相册中选图片
sapp.util.chooseImage({
count: 9, // 最多选择数量
sourceType: 'album', // 可以指定来源是相册还是相机(album,camera),默认相册
success: (res) => {
const files = res.data // 返回选定照片的url
},
fail: (error) => {
// 获取失败
}
})
窗口接口
设置状态栏样式
sapp.util.setStatusBarStyle({ style: 'light' }) // "light" 时状态栏字体为白色,"dark" 则为黑色
设置状态栏背景色
sapp.util.setStatusBarBackground({ color: '#F5F5F5' }) // color 为#RRGGBB值
显示安全区域
安全区域表示iPhoneX以上手机的底部会有留白
sapp.util.showSafearea({ backgroundColor: '#F5F5F5' }) // backgroundColor 为#RRGGBB值
隐藏安全区域
sapp.util.hideSafearea()
获取状态栏高度
sapp.util.getStatusbarHeight({
success: (res) => {
const height = res.data // 获取成功
},
fail: (error) => {
// 获取失败
}
})
获取安全区域高度
sapp.util.getSafeAreaHeight({
success: (res) => {
const height = res.data // 获取成功
},
fail: (error) => {
// 获取失败
}
})
1.2.0
3 years ago
1.1.7
3 years ago
1.1.6
3 years ago
1.1.5
3 years ago
1.1.4
3 years ago
1.2.1
3 years ago
1.2.11
3 years ago
1.1.3
3 years ago
1.1.2
3 years ago
1.1.1
3 years ago
1.1.0
3 years ago
1.0.8
3 years ago
1.0.6
3 years ago
1.0.5
3 years ago
1.0.4
3 years ago
1.0.3
3 years ago
1.0.2
3 years ago
1.0.1
3 years ago
1.0.0
3 years ago