【小程序】基础API之系统API接口汇总

小程序基础API之系统API接口汇总

最新推荐文章于 2024-07-14 23:00:00 发布

原创

最新推荐文章于 2024-07-14 23:00:00 发布 · 1.9k 阅读

30 ·

CC 4.0 BY-SA版权

文章标签：

#小程序 #前端 #javascript #iot #App #系统架构

本文介绍了Ty库中涉及的几个关键功能，如环境变量管理（USER_DATA_PATH）、文件系统操作（如写入和分享文件）、获取系统信息（如设备品牌、操作系统等）、设备设置控制以及针对iOS的快捷方式操作。

ty.env

环境变量

属性

USER_DATA_PATH `string`

文件系统中的用户目录路径 (本地路径)，当操作文件时需使用此目录。

// 写入一个文件
const fileManager = await ty.getFileSystemManager();
const fileRoot = ty.env.USER_DATA_PATH;
const filePath = `${fileRoot}/test.json`
await fileManager.writeFile({
  filePath: filePath,
  data: `{"test": "test"}`,
});
 
// 分享该文件
ty.share({
  title: '分享一个文件',
  message: '这是一个 JSON 文件，调用系统分享',
  type: 'More',
  filePath: filePath,
  contentType: 'file',
  success() {
    console.log('分享成功');
  },
  fail(err) {
    console.log('分享失败', err);
  },
});

其他文件操作方法请参考 FileSystemManager。

ty.getSystemInfo

获取系统信息

需引入BaseKit，且在>=1.2.10版本才可使用

参数

Object object

属性	类型	必填	说明
complete	`function`	否	接口调用结束的回调函数（调用成功、失败都会执行）
success	`function`	否	接口调用成功的回调函数
fail	`function`	否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
is24Hour	`boolean`
system	`string`
brand	`string`
model	`string`
platform	`string`
timezoneId	`string`
pixelRatio	`number`
screenWidth	`number`
screenHeight	`number`
windowWidth	`number`
windowHeight	`number`
statusBarHeight	`number`
language	`string`
safeArea	`SafeArea`
albumAuthorized	`boolean`
cameraAuthorized	`boolean`
locationAuthorized	`boolean`
microphoneAuthorized	`boolean`
notificationAuthorized	`boolean`
notificationAlertAuthorized	`boolean`
notificationBadgeAuthorized	`boolean`
notificationSoundAuthorized	`boolean`
bluetoothEnabled	`boolean`
locationEnabled	`boolean`
wifiEnabled	`boolean`
theme	`Themes`
deviceOrientation	`Orientation`

SafeArea

属性	类型	说明
left	`number`	安全区域左上角横坐标
right	`number`	安全区域右下角横坐标
top	`number`	安全区域左上角纵坐标
bottom	`number`	安全区域右下角纵坐标
width	`number`	安全区域的宽度，单位逻辑像素
height	`number`	安全区域的高度，单位逻辑像素