接口 Ymx

只读coreVersion

只读isAndroid

只读isHarmony

只读isIos

chooseMedia

• chooseMedia(data: ChooseMediaData): Promise<ChooseMediaResult>

  拍摄或从手机相册中选择图片或视频

  参数

  • data: ChooseMediaData

  返回 Promise<ChooseMediaResult>

  示例

  ymx.chooseMedia({
    // 相册
    sourceType: ['album'],
    // 选一个
    count: 1,
    mediaType: ['image'],
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

  示例

  ymx.chooseMedia({
    // 相册
    sourceType: ['album'],
    // 选 3 个
    count: 3,
    mediaType: ['image'],
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

  示例

  ymx.chooseMedia({
    // 拍照
    sourceType: ['camera'],
    // 后置摄像头
    camera: 'back',
    mediaType: ['image'],
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

  示例

  ymx.chooseMedia({
    // 拍照
    sourceType: ['camera'],
    // 前置摄像头
    camera: 'front',
    mediaType: ['video'],
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

clearStorage

• clearStorage(): Promise<void>

  清理本地数据缓存

  返回 Promise<void>

  示例

  ymx.clearStorage().then(() => {
    alert('success');
  });
  复制

downloadFile

• downloadFile(data: DownloadFileData): Promise<DownloadFileResult>

  下载文件

  参数

  • data: DownloadFileData

  返回 Promise<DownloadFileResult>

  示例

  ymx.downloadFile({
    url: 'https://www.yimenapp.com/doc/doc.pdf'
  }).then(res => {
    alert(JSON.stringify(res));
  }).catch((err) => {
    alert(`download error: ${JSON.stringify(err)}`);
  });
  复制

exit

• exit(): Promise<void>

  退出应用

  返回 Promise<void>

  示例

  ymx.exit();
  复制

getDeclaredPermissions

• getDeclaredPermissions(): Promise<DeclaredPermissionsResult>

  获取应用已申明的权限清单

  返回 Promise<DeclaredPermissionsResult>

  示例

  ymx.getDeclaredPermissions()
    .then(res => {
      alert(JSON.stringify(res));
    });
  复制

getLayout

• getLayout(): Promise<Layout>

  获取布局选项

  返回 Promise<Layout>

getNavigationBar

• getNavigationBar(): Promise<NavigationBar>

  获取导航栏（底部虚拟按键区）

  返回 Promise<NavigationBar>

getScreenOrientation

• getScreenOrientation(): Promise<ScreenOrientation>

  获取屏幕方向

  返回 Promise<ScreenOrientation>

getStatusBar

• getStatusBar(): Promise<StatusBar>

  获取状态栏

  返回 Promise<StatusBar>

getStorage

• getStorage(data: StorageKey): Promise<StorageResult>

  从本地缓存中异步获取指定 key 的内容

  参数

  • data: StorageKey

  返回 Promise<StorageResult>

  示例

  ymx.getStorage({
    key: 'key1'
  }).then(res => {
    alert(res.data);
  });
  复制

  示例

  ymx.getStorage({
    key: 'key2'
  }).then(res => {
    alert(JSON.stringify(res.data));
  });
  复制

getStorageInfo

• getStorageInfo(): Promise<StorageInfoResult>

  异步获取当前 storage 的相关信息

  返回 Promise<StorageInfoResult>

  示例

  ymx.getStorageInfo().then(res => {
    alert(JSON.stringify(res));
  });
  复制

getTheme

• getTheme(): Promise<Theme>

  获取主题

  返回 Promise<Theme>

getTitleBar

• getTitleBar(): Promise<TitleBar>

  获取标题栏

  返回 Promise<TitleBar>

hasPermissionDeclared

• hasPermissionDeclared(
      permission: PermissionData,
  ): Promise<PermissionDeclaredResult>

  指定的权限是否存在于权限清单中

  参数

  • permission: PermissionData

  返回 Promise<PermissionDeclaredResult>

  示例

  ymx.hasPermissionDeclared({
    permission: 'ohos.permission.LOCATION'
  }).then(res => {
      alert(JSON.stringify(res));
    });
  复制

hasPermissionGranted

• hasPermissionGranted(permission: PermissionData): Promise<PermissionResult>

  是否已获得指定的权限

  参数

  • permission: PermissionData

    权限

  返回 Promise<PermissionResult>

  示例

  ymx.hasPermissionGranted({
    permission: 'ohos.permission.LOCATION'
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

hideLoading

• hideLoading(): Promise<void>

  隐藏 loading 提示

  返回 Promise<void>

  示例

  ymx.hideLoading();
  复制

hideToast

• hideToast(): Promise<void>

  隐藏吐司提示

  返回 Promise<void>

  示例

  ymx.hideToast();
  复制

openPermissionSetting

• openPermissionSetting(permissions: PermissionsData): Promise<PermissionsResult>

  打开权限设置界面，手动授权。

  • 鸿蒙 requestPermissionOnSetting

  1. 权限必需在应用的权限清单中
  2. 需要先调用 requestPermission 用户明确拒绝后能 requestPermissionOnSetting

  参数

  • permissions: PermissionsData

  返回 Promise<PermissionsResult>

  示例

  ymx.openPermissionSetting({
    permissions: ['ohos.permission.APPROXIMATELY_LOCATION']
  }).then(res => {
    alert(JSON.stringify(res));
  }).catch((err) => {
    alert(err.message);
  });
  复制

removeStorage

• removeStorage(data: StorageKey): Promise<void>

  从本地缓存中移除指定 key

  参数

  • data: StorageKey

  返回 Promise<void>

  示例

  ymx.removeStorage({
    key: 'key1'
  }).then(() => {
    alert('success');
  });
  复制

request

• request(data: RequestData): Promise<RequestResult>

  网络请求

  参数

  • data: RequestData

  返回 Promise<RequestResult>

  示例

  ymx.request({
    url: 'https://www.yimenapp.com/doc/echo2',
    method: 'POST',
    data: {
      key1: 'value 1',
      hello: '世界'
    }
  }).then(res => {
    alert(JSON.stringify(res));
  }).catch((err) => {
    alert(`request error: ${JSON.stringify(err)}`);
  });
  复制

  示例

  ymx.request({
    url: 'https://www.yimenapp.com/doc/echo2',
    method: 'GET'
  }).then(res => {
    alert(JSON.stringify(res));
  }).catch((err) => {
    alert(`request error: ${JSON.stringify(err)}`);
  });
  复制

requestPermission

• requestPermission(permission: RequestPermissionData): Promise<PermissionResult>

  请求单个权限

  参数

  • permission: RequestPermissionData

    权限

  返回 Promise<PermissionResult>

  是否已同意授权

  示例

  ymx.requestPermission({
    permission: 'ohos.permission.APPROXIMATELY_LOCATION'
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

requestPermissions

• requestPermissions(
      permissions: RequestPermissionsData,
  ): Promise<PermissionsResult>

  请求多个权限

  参数

  • permissions: RequestPermissionsData

    权限组

  返回 Promise<PermissionsResult>

  权限组参数的授权结果

  示例

  ymx.requestPermissions({
    permissions: ['ohos.permission.LOCATION', 'ohos.permission.APPROXIMATELY_LOCATION'],
    openSettingIfDenied: true
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

requirePlugin

• requirePlugin(pluginId: string): object

  构建插件 js API 接口实例

  此接口返回 object 类型，为获得接口类型验证和智能提示，请按如下操作：

  • 安装插件的 TypeScript 接口类型定义包，以 ymx-wechat 插件为例

  npm install --save @ymxjs/ymx-wechat
  复制

  • 将 requirePlugin 返回值强制转换为插件的对应类型 YmxWechat

  const wechat = ymx.requirePlugin('ymx-wechat') as YmxWechat;
  // 至此，调用 wechat 下的接口即可获得开发环境类型验证和智能提示
  // wechat.login...
  复制

  参数

  • pluginId: string

    插件 ID

  返回 object

setLayout

• setLayout(layout: Layout): Promise<void>

  设置布局选项

  参数

  • layout: Layout

    布局选项

  返回 Promise<void>

setNavigationBar

• setNavigationBar(navigationBar: NavigationBar): Promise<void>

  设置导航栏（底部虚拟按键区）

  参数

  • navigationBar: NavigationBar

    导航栏

  返回 Promise<void>

setScreenOrientation

• setScreenOrientation(screenOrientation: ScreenOrientation): Promise<void>

  设置屏幕方向

  参数

  • screenOrientation: ScreenOrientation

    屏幕方向

  返回 Promise<void>

setStatusBar

• setStatusBar(statusBar: StatusBar): Promise<void>

  设置状态栏

  参数

  • statusBar: StatusBar

    状态栏

  返回 Promise<void>

setStorage

• setStorage(data: StorageData): Promise<void>

  将数据存储在本地缓存中指定的 key 中。会覆盖掉原来该 key 对应的内容。除非用户主动删除或因存储空间原因被系统清理，否则数据都一直可用。单个 key 允许存储的最大数据长度为 1MB，所有数据存储上限为 10MB。

  参数

  • data: StorageData

  返回 Promise<void>

  示例

  ymx.setStorage({
    key: 'key1',
    data: 'value 1'
  }).then(() => {
    alert('success');
  });
  复制

  示例

  ymx.setStorage({
    key: 'key2',
    data: {
      name: '张三',
      age: 26
    }
  }).then(() => {
    alert('success');
  });
  复制

setTheme

• setTheme(theme: Theme): Promise<void>

  设置主题

  参数

  • theme: Theme

    主题

  返回 Promise<void>

setTitleBar

• setTitleBar(titleBar: TitleBar): Promise<void>

  设置标题栏

  参数

  • titleBar: TitleBar

    标题栏

  返回 Promise<void>

showActionSheet

• showActionSheet(data: ShowActionSheetData): Promise<ShowActionSheetResult>

  显示操作菜单

  参数

  • data: ShowActionSheetData

  返回 Promise<ShowActionSheetResult>

  示例

  ymx.showActionSheet({
    alertText: '请选择',
    itemList: ['选项1', '选项2', '选项3'],
    itemColor: '#FF0000',
  }).then((res) => {
    alert(res.tapIndex);
  });
  复制

showLoading

• showLoading(data: ShowLoadingData): Promise<void>

  显示 loading 提示

  参数

  • data: ShowLoadingData

  返回 Promise<void>

  示例

  ymx.showLoading({
    title: '加载中...',
    mask: true
  });
  复制

showModal

• showModal(data: ShowModalData): Promise<ShowModalResult>

  显示模态弹框

  参数

  • data: ShowModalData

  返回 Promise<ShowModalResult>

  示例

  ymx.showModal({
    title: '确认',
    content: '确实退出吗？',
    confirmText: '退出',
    cancelText: '取消'
  }).then(res => {
    alert(JSON.stringify(res));
  });
  复制

showToast

• showToast(data: ShowToastData): Promise<void>

  吐司提示

  参数

  • data: ShowToastData

  返回 Promise<void>

  示例

  ymx.showToast({
    title: 'hello world',
    duration: 2000
  });
  复制

uploadFile

• uploadFile(data: UploadFileData): Promise<UploadFileResult>

  上传文件

  参数

  • data: UploadFileData

  返回 Promise<UploadFileResult>

  示例

  // 选文件
  ymx.chooseMedia({
    sourceType: ['album'],
    mediaType: ['image'],
    count: 1
  }).then(choose => {
    // 上传
    ymx.uploadFile({
      url: 'https://www.yimenapp.com/doc/echo2',
      filePath: choose.tempFiles[0].tempFilePath
    }).then(res => {
      alert(JSON.stringify(res));
    }).catch((uploadErr) => {
      alert(`upload error: ${JSON.stringify(uploadErr)}`);
    });
  }).catch((chooseErr) => {
    alert(`choose error: ${JSON.stringify(chooseErr)}`);
  });
  复制