uniapp常用接口
uniapp常用接口分类
uniapp作为跨平台开发框架,提供了丰富的API接口以满足不同场景需求,主要分为以下几大类:
网络请求
使用uni.request发起HTTP请求,支持Promise风格调用:
uni.request({
url: 'https://example.com/api',
method: 'GET',
success: (res) => console.log(res.data)
});
数据缓存
uni.setStorage和uni.getStorage实现本地数据存储:
uni.setStorage({
key: 'user_token',
data: 'abcdef123456'
});
媒体操作
uni.chooseImage选择图片,uni.previewImage预览图片:
uni.chooseImage({
count: 3,
success: (res) => console.log(res.tempFilePaths)
});
设备相关
uni.getSystemInfo获取设备信息:
uni.getSystemInfo({
success: (res) => console.log(res.model)
});
位置服务
uni.getLocation获取当前位置:
uni.getLocation({
type: 'wgs84',
success: (res) => console.log(res.latitude)
});
界面交互
uni.showToast显示提示框:

uni.showToast({
title: '操作成功',
icon: 'success'
});
支付功能
uni.requestPayment调用支付接口:
uni.requestPayment({
provider: 'wxpay',
orderInfo: '...',
success: (res) => console.log(res)
});
文件操作
uni.uploadFile实现文件上传:
uni.uploadFile({
url: 'https://example.com/upload',
filePath: tempFilePath,
name: 'file'
});
导航相关
uni.navigateTo页面跳转:
uni.navigateTo({
url: '/pages/detail?id=1'
});
扫码功能
uni.scanCode调用扫码接口:

uni.scanCode({
success: (res) => console.log(res.result)
});
扩展能力接口
蓝牙操作
uni.openBluetoothAdapter初始化蓝牙模块:
uni.openBluetoothAdapter({
success: (res) => console.log(res)
});
传感器
uni.onAccelerometerChange监听加速度计:
uni.onAccelerometerChange((res) => {
console.log(res.x, res.y, res.z);
});
全局事件
uni.$on和uni.$emit实现跨页面通信:
// 页面A
uni.$emit('update', {data: newData});
// 页面B
uni.$on('update', (data) => console.log(data));
平台专有接口
微信小程序专有
uni.login获取微信登录凭证:
uni.login({
provider: 'weixin',
success: (res) => console.log(res.code)
});
APP端专有
uni.getPushClientId获取推送标识:
uni.getPushClientId({
success: (res) => console.log(res.cid)
});
注意事项
- 部分接口需要配置manifest.json权限声明
- 平台差异接口需判断运行环境:
// #ifdef H5 console.log('仅在H5平台执行'); // #endif - 异步接口推荐使用Promise封装提高代码可读性






