查询默认应用的能力

2024-01-23 13:05 更新

本模块提供查询默认应用的能力,支持查询当前应用是否是默认应用。

说明

本模块首批接口从API version 9开始支持。后续版本的新增接口,采用上角标单独标记接口的起始版本。

导入模块

  1. import defaultAppMgr from '@ohos.bundle.defaultAppManager';

权限列表

权限

权限等级

描述

ohos.permission.GET_DEFAULT_APPLICATION

system_core

默认应用相关权限。

权限等级参考权限等级说明

defaultAppMgr.ApplicationType

默认应用的应用类型。

系统能力: SystemCapability.BundleManager.BundleFramework.DefaultApp

名称

说明

BROWSER

"Web Browser"

默认浏览器。

IMAGE

"Image Gallery"

默认图片查看器。

AUDIO

"Audio Player"

默认音频播放器。

VIDEO

"Video Player"

默认视频播放器。

PDF

"PDF Viewer"

默认PDF文档查看器。

WORD

"Word Viewer"

默认WORD文档查看器。

EXCEL

"Excel Viewer"

默认EXCEL文档查看器。

PPT

"PPT Viewer"

默认PPT文档查看器。

defaultAppMgr.isDefaultApplication

isDefaultApplication(type: string): Promise<boolean>

以异步方法根据系统已定义的应用类型判断当前应用是否是该应用类型的默认应用,使用Promise形式返回结果。

系统能力: SystemCapability.BundleManager.BundleFramework.DefaultApp

参数:

参数名

类型

必填

说明

type

string

要查询的应用类型,取ApplicationType中的值。

返回值:

类型

说明

Promise<boolean>

Promise形式返回当前应用是否是默认应用,true表示是默认应用,false表示不是默认应用。

示例:

  1. import defaultAppMgr from '@ohos.bundle.defaultAppManager';
  2. defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER)
  3. .then((data) => {
  4. console.info('Operation successful. IsDefaultApplication ? ' + JSON.stringify(data));
  5. }).catch((error) => {
  6. console.error('Operation failed. Cause: ' + JSON.stringify(error));
  7. });

defaultAppMgr.isDefaultApplication

isDefaultApplication(type: string, callback: AsyncCallback<boolean>): void

以异步方法根据系统已定义的应用类型判断当前应用是否是该应用类型的默认应用,使用callback形式返回结果。

系统能力: SystemCapability.BundleManager.BundleFramework.DefaultApp

参数:

参数名

类型

必填

说明

type

string

要查询的应用类型,取ApplicationType中的值。

callback

AsyncCallback<boolean>

程序启动作为入参的回调函数,返回当前应用是否是默认应用,true表示是默认应用,false表示不是默认应用。

示例:

  1. import defaultAppMgr from '@ohos.bundle.defaultAppManager';
  2. defaultAppMgr.isDefaultApplication(defaultAppMgr.ApplicationType.BROWSER, (err, data) => {
  3. if (err) {
  4. console.error('Operation failed. Cause: ' + JSON.stringify(err));
  5. return;
  6. }
  7. console.info('Operation successful. IsDefaultApplication ? ' + JSON.stringify(data));
  8. });
以上内容是否对您有帮助:
在线笔记
App下载
App下载

扫描二维码

下载编程狮App

公众号
微信公众号

编程狮公众号