鸿蒙应用示例：API 功能集成示例及注意事项

The API is not supported on all devices. Use the canIUse condition to determine whether the API is supported.

if (canIUse('SystemCapability.Telephony.Call')) {  call.makeCall("13800000000", (err: BusinessError) => {    if (err) {      console.error(`makeCall fail, err->${JSON.stringify(err)}`);    } else {      console.log(`makeCall success`);    }  });} else {  promptAction.showToast({    message: `当前设备不支持拨打电话功能`,    duration: 2000,    bottom: '500lpx'  });}

import { bundleManager, common, Want } from '@kit.AbilityKit';import { BusinessError, deviceInfo } from '@kit.BasicServicesKit';import { call } from '@kit.TelephonyKit';import { scanBarcode, scanCore } from '@kit.ScanKit';import { hilog } from '@kit.PerformanceAnalysisKit';import { promptAction, window } from '@kit.ArkUI';import { connection } from '@kit.NetworkKit';import { camera, cameraPicker } from '@kit.CameraKit';import { photoAccessHelper } from '@kit.MediaLibraryKit';import { resourceManager } from '@kit.LocalizationKit';import { AAID } from '@kit.PushKit';
function getMmsWant() {  let want: Want = {    bundleName: 'com.ohos.mms',    abilityName: 'com.ohos.mms.MainAbility',    parameters: {      contactObjects: JSON.stringify([{ "contactsName": 'ZhangSan', "telephone": "16888880000" }]),      content: "短信内容测试321",      pageFlag: 'conversation'    }  };  return want}
function getBrowsableWant() {  let want: Want = {    action: 'ohos.want.action.viewData',    entities: ['entity.system.browsable'],    uri: 'https://www.huawei.com'  };  return want}
function getAppGalleryDetailWant() {  let bundleName = "com.amap.hmapp"  let want: Want = {    action: 'ohos.want.action.appdetail',    uri: 'store://appgallery.huawei.com/app/detail?id=' + bundleName, //  bundleName为需要打开应用详情的应用的包名  };  return want}
function getWifiEntryWant() {  let want: Want = {    bundleName: 'com.huawei.hmos.settings',    abilityName: 'com.huawei.hmos.settings.MainAbility',    uri: 'wifi_entry'  // 根据”设置”应用配置的界面信息，选择不同的uri  };  return want}

function getSetInputWant() {  let want: Want = {    bundleName: 'com.huawei.hmos.settings',    abilityName: 'com.huawei.hmos.settings.MainAbility',    uri: 'set_input'  // 根据”设置”应用配置的界面信息，选择不同的uri  };  return want}

function getLocationManagerSettingsWant() {  let want: Want = {    bundleName: 'com.huawei.hmos.settings',    abilityName: 'com.huawei.hmos.settings.MainAbility',    uri: 'location_manager_settings'  // 根据”设置”应用配置的界面信息，选择不同的uri  };  return want}
function makeCall() {  if (canIUse("SystemCapability.Applications.Contacts")) {    call.makeCall("13800000000", (err: BusinessError) => {      if (err) {        console.error(`makeCall fail, err->${JSON.stringify(err)}`);      } else {        console.log(`makeCall success`);      }    });  } else {    promptAction.showToast({      message: `当前设备不支持该功能`,      duration: 2000,      bottom: '500lpx'    });  }}
function scanCode(context: common.UIAbilityContext) {  if (canIUse('SystemCapability.Multimedia.Scan.ScanBarcode')) {    if (canIUse('SystemCapability.Multimedia.Scan.Core')) {      // 定义扫码参数options      let options: scanBarcode.ScanOptions = {        scanTypes: [scanCore.ScanType.ALL],        enableMultiMode: true,        enableAlbum: true      };      // 可调用getContext接口获取当前页面关联的UIAbilityContext      scanBarcode.startScanForResult(context, options,        (error: BusinessError, result: scanBarcode.ScanResult) => {          if (error) {            hilog.error(0x0001, '[Scan CPSample]',              `Failed to get ScanResult by callback with options. Code: ${error.code}, message: ${error.message}`);            return;          }          // 收到扫码结果后返回          hilog.info(0x0001, '[Scan CPSample]',            `Succeeded in getting ScanResult by callback with options, result is ${JSON.stringify(result)}`);          promptAction.showToast({            message: `扫码结果：${JSON.stringify(result)}`,            duration: 2000,            bottom: '500lpx'          });        })      return    }  }  promptAction.showToast({    message: `当前设备不支持该功能`,    duration: 2000,    bottom: '500lpx'  });}
function checkApp() {  try {    let link: string = "amapuri://"    let appName: string = "高德地图"    let data = bundleManager.canOpenLink(link);    hilog.info(0x0000, 'testTag', 'canOpenLink successfully: %{public}s', JSON.stringify(data));    if (data) {      promptAction.showToast({        message: `${appName} APP 已安装`,        duration: 2000,        bottom: '500lpx'      });    } else {      promptAction.showToast({        message: `${appName} APP 未安装`,        duration: 2000,        bottom: '500lpx'      });    }  } catch (err) {    if (err['code'] == 17700056) {      /*{      "module": {        "querySchemes": [          "amapuri",        ],*/      promptAction.showToast({        message: '请在src/main/module.json5配置link,参考注释 querySchemes',        duration: 2000,        bottom: '500lpx'      });    } else {      promptAction.showToast({        message: '未知异常',        duration: 2000,        bottom: '500lpx'      });    }    let message = (err as BusinessError).message;    hilog.error(0x0000, 'testTag', 'canOpenLink failed: %{public}s', message);  }}
function getAppInfo() {  let bundleFlags =    bundleManager.BundleFlag.GET_BUNDLE_INFO_DEFAULT | bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_APPLICATION |    bundleManager.BundleFlag.GET_BUNDLE_INFO_WITH_METADATA;  let bundleInfo = bundleManager.getBundleInfoForSelfSync(bundleFlags)
  console.info('bundleInfo', JSON.stringify(bundleInfo))  let sheets: SheetInfo[] = []  Object.keys(bundleInfo).forEach((key: string) => {    sheets.push({      title: `${key}:${JSON.stringify(bundleInfo[key])}`,      action: () => {      }    })  })  ActionSheet.show({    title: '当前应用信息',    subtitle: '',    message: '',    autoCancel: true,    confirm: {      defaultFocus: true,      value: 'Confirm button',      action: () => {        console.log('Get Alert Dialog handled')      }    },    cancel: () => {      console.log('actionSheet canceled')    },    alignment: DialogAlignment.Bottom,    offset: { dx: 0, dy: -10 },    sheets: sheets  })}
function getDeviceInfo() {  ActionSheet.show({    title: '当前设备信息',    subtitle: '',    message: '',    autoCancel: true,    confirm: {      defaultFocus: true,      value: 'Confirm button',      action: () => {        console.log('Get Alert Dialog handled')      }    },    cancel: () => {      console.log('actionSheet canceled')    },    alignment: DialogAlignment.Bottom,    offset: { dx: 0, dy: -10 },    sheets: [      {        title: '设备品牌名称:' + deviceInfo.brand,        action: () => {        }      },      {        title: '产品版本:' + deviceInfo.displayVersion,        action: () => {        }      },      {        title: '系统版本:' + deviceInfo.osFullName,        action: () => {        }      },      {        title: '系统软件API版本:' + deviceInfo.sdkApiVersion,        action: () => {        }      },      {        title: '首个版本系统软件API版本:' + deviceInfo.firstApiVersion,        action: () => {        }      },      {        title: '构建时间:' + deviceInfo.buildTime,        action: () => {        }      },      {        title: '发行版系统api版本:' + deviceInfo.distributionOSApiVersion,        action: () => {        }      },    ]  })}
async function setWindowPrivacyModeTrue(context: common.UIAbilityContext) {  let windowClass: window.Window = await window.getLastWindow(context)  try {    windowClass.setWindowPrivacyMode(true, (err: BusinessError) => {      const errCode: number = err.code;      if (errCode) {        console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(err));        if (errCode == 201) {          /*          {            "module": {              "requestPermissions": [                {                  "name": "ohos.permission.INTERNET"                }              ],*/          promptAction.showToast({            message: `请在src/main/module.json5添加权限 "name": "ohos.permission.PRIVACY_WINDOW"`,            duration: 2000,            bottom: '500lpx'          });        }        return;      }      promptAction.showToast({        message: `已开启 防截屏录屏`,        duration: 2000,        bottom: '500lpx'      });      console.info('Succeeded in setting the window to privacy mode.');    });  } catch (exception) {    console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(exception));  }}
async function setWindowPrivacyModeFalse(context: common.UIAbilityContext) {  let windowClass: window.Window = await window.getLastWindow(context)  try {    windowClass.setWindowPrivacyMode(false, (err: BusinessError) => {      const errCode: number = err.code;      if (errCode) {        console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(err));        if (errCode == 201) {
          promptAction.showToast({            message: `请在src/main/module.json5添加权限 "name": "ohos.permission.PRIVACY_WINDOW"`,            duration: 2000,            bottom: '500lpx'          });        }        return;      }      promptAction.showToast({        message: `已关闭 防截屏录屏`,        duration: 2000,        bottom: '500lpx'      });      console.info('Succeeded in setting the window to privacy mode.');    });  } catch (exception) {    console.error('Failed to set the window to privacy mode. Cause:' + JSON.stringify(exception));  }}
function netConnectionListener() {  let netCon: connection.NetConnection = connection.createNetConnection();  // 先使用register接口注册订阅事件  netCon.register((error: BusinessError) => {    console.log(JSON.stringify(error));    if (error) {      if (error.code == 201) {        promptAction.showToast({          message: `请在src/main/module.json5添加权限 "name": "ohos.permission.GET_NETWORK_INFO"`,          duration: 2000,          bottom: '500lpx'        });      } else {        promptAction.showToast({          message: `${JSON.stringify(error)}`,          duration: 2000,          bottom: '500lpx'        });      }      return;    }    promptAction.showToast({      message: `已开启 网络状态监听`,      duration: 2000,      bottom: '500lpx'    });  });  // 订阅网络丢失事件。调用register后，才能接收到此事件通知  netCon.on('netLost', (data: connection.NetHandle) => {    console.info("Succeeded to get data: netLost " + JSON.stringify(data));    promptAction.showToast({      message: `已关闭 网络`,      duration: 2000,      bottom: '500lpx'    });  });  // 订阅网络能力变化事件。调用register后，才能接收到此事件通知  netCon.on('netConnectionPropertiesChange', (data: connection.NetConnectionPropertyInfo) => {    console.info("Succeeded to get data: netConnectionPropertiesChange " + JSON.stringify(data));    promptAction.showToast({      message: `已开启 网络`,      duration: 2000,      bottom: '500lpx'    });  });}
async function startCameraPicker(context: common.UIAbilityContext) {  try {    let pickerProfile: cameraPicker.PickerProfile = {      cameraPosition: camera.CameraPosition.CAMERA_POSITION_BACK    };    let pickerResult: cameraPicker.PickerResult = await cameraPicker.pick(context,      [cameraPicker.PickerMediaType.PHOTO, cameraPicker.PickerMediaType.VIDEO], pickerProfile);    console.log("the pick pickerResult is:" + JSON.stringify(pickerResult)); //拍照结果    if (pickerResult.resultCode == 0) {      context.eventHub.emit("updateImage", pickerResult.resultUri)    }  } catch (error) {    let err = error as BusinessError;    console.error(`the pick call failed. error code: ${err.code}`);  }}
function selectPhoto(context: common.UIAbilityContext) {  try {    let PhotoSelectOptions = new photoAccessHelper.PhotoSelectOptions();    PhotoSelectOptions.MIMEType = photoAccessHelper.PhotoViewMIMETypes.IMAGE_TYPE;    PhotoSelectOptions.maxSelectNumber = 1;    let photoPicker = new photoAccessHelper.PhotoViewPicker();    photoPicker.select(PhotoSelectOptions).then((PhotoSelectResult: photoAccessHelper.PhotoSelectResult) => {      console.info('PhotoViewPicker.select successfully, PhotoSelectResult uri: ' + JSON.stringify(PhotoSelectResult));      if (PhotoSelectResult.photoUris?.[0]) {        context.eventHub.emit("updateImage", PhotoSelectResult.photoUris?.[0])      }    }).catch((err: BusinessError) => {      console.error(`PhotoViewPicker.select failed with err: ${err.code}, ${err.message}`);    });  } catch (error) {    let err: BusinessError = error as BusinessError;    console.error(`PhotoViewPicker failed with err: ${err.code}, ${err.message}`);  }}
function setAppLandscapeOrientation() {  window.getLastWindow(getContext()).then((windowClass) => {    windowClass.setPreferredOrientation(window.Orientation.PORTRAIT)  })}
function setAppPortraitOrientation() {  window.getLastWindow(getContext()).then((windowClass) => {    windowClass.setPreferredOrientation(window.Orientation.LANDSCAPE)  })}
function detectAppOrientation() {  promptAction.showToast({    message: getContext().resourceManager.getConfigurationSync().direction ===    resourceManager.Direction.DIRECTION_VERTICAL ?      "竖屏" : "横屏"  })}
function getDeviceType() {  let getDeviceTypeInfo = () => {    let      deviceType = getContext().resourceManager.getDeviceCapabilitySync().deviceType;    switch (deviceType) {      case resourceManager.DeviceType.DEVICE_TYPE_PHONE:        return "手机";      case resourceManager.DeviceType.DEVICE_TYPE_TABLET:        return "平板";      case resourceManager.DeviceType.DEVICE_TYPE_PC:        return "电脑";      case resourceManager.DeviceType.DEVICE_TYPE_TV:        return "电视";      case resourceManager.DeviceType.DEVICE_TYPE_CAR:        return "汽车";      case resourceManager.DeviceType.DEVICE_TYPE_WEARABLE:        return "穿戴";      case resourceManager.DeviceType.DEVICE_TYPE_2IN1:        return "2IN1";      default:        return "未知"    }  }  promptAction.showToast({    message: getDeviceTypeInfo()  })}
function getDefaultNet() {  let isDefaultNet = connection.hasDefaultNetSync();  promptAction.showToast({    message: `当前${isDefaultNet ? '有网络' : '无网络'}`  })}
function getConnectionProperties() {  connection.getDefaultNet().then((netHandle: connection.NetHandle) => {    connection.getConnectionProperties(netHandle, (error: BusinessError, data: connection.ConnectionProperties) => {      if (error) {        console.error(`Failed to get connection properties. Code:${error.code}, message:${error.message}`);        return;      }      console.info("Succeeded to get data: " + JSON.stringify(data));      try {        let ip = data['linkAddresses'][0]['address']['address']        console.info('本地ip：', ip)        promptAction.showToast({          message: `当前ip:${ip}`        })      } catch (e) {        console.error("e", JSON.stringify(e));
      }
    })  });
}
function getAAID() {  AAID.getAAID().then((data: string) => {    ActionSheet.show({      title: '当前AAID',      subtitle: `${data}`,      message: `实测当用户主动卸载APP后重新安装时，AAID值会改变。`,      autoCancel: true,      confirm: {        defaultFocus: true,        value: 'Confirm button',        action: () => {          console.log('Get Alert Dialog handled')        }      },      cancel: () => {        console.log('actionSheet canceled')      },      alignment: DialogAlignment.Bottom,      offset: { dx: 0, dy: -10 },      sheets: [        {          title: '如果希望卸载APP后依旧不变，建议使用第三方harmony-utils',          action: () => {          }        }      ]    })    hilog.info(0x0000, 'testTag', 'Get AAID successfully: %{public}s', data);  }).catch((err: BusinessError) => {    hilog.error(0x0000, 'testTag', 'Get AAID failed: %{public}d %{public}s', err.code, err.message);  });}
class Item {  key: string  want: Want | Function
  constructor(key: string, want: Want | Function) {    this.key = key    this.want = want  }}
//拉起功能示例@Entry@Componentstruct Index {  @State array: Item[] = []  @State imageUrl: string | undefined = undefined
  aboutToAppear(): void {
    getContext(this).eventHub.on('updateImage', (data: string) => {      this.imageUrl = data      console.info('imageUrl', this.imageUrl)    })
    this.array.push(new Item('获取设备的AAID', getAAID))    this.array.push(new Item('拉起短信界面并指定联系人', getMmsWant()))    this.array.push(new Item('拉起浏览器并打开指定网页', getBrowsableWant()))    this.array.push(new Item('拉起应用市场对应的应用详情界面', getAppGalleryDetailWant()))    this.array.push(new Item('拉起设置应用HOME-WLAN界面', getWifiEntryWant()))    this.array.push(new Item('拉起HOME-系统和更新-输入法页面', getSetInputWant()))    this.array.push(new Item('拉起开启定位的设置页', getLocationManagerSettingsWant()))    this.array.push(new Item('拉起拨号界面并显示待拨出的号码', makeCall))    this.array.push(new Item('拉起扫码页面', scanCode))    this.array.push(new Item('判断是否安装了某个APP', checkApp))    this.array.push(new Item('获取应用信息', getAppInfo))    this.array.push(new Item('获取设备信息', getDeviceInfo))    this.array.push(new Item('开启防截屏录屏', setWindowPrivacyModeTrue))    this.array.push(new Item('关闭防截屏录屏', setWindowPrivacyModeFalse))    this.array.push(new Item('开启网络状态监听', netConnectionListener))    this.array.push(new Item('判断当前网络链接状态', getDefaultNet))    this.array.push(new Item('获取手机当前连接wifi的本机ip', getConnectionProperties))    this.array.push(new Item('拉起相机', startCameraPicker))    this.array.push(new Item('拉起相册', selectPhoto))    this.array.push(new Item('设置当前app以竖屏方式显示', setAppLandscapeOrientation))    this.array.push(new Item('设置当前app以横屏方式显示', setAppPortraitOrientation))    this.array.push(new Item('判断APP是横屏还是竖屏', detectAppOrientation))    this.array.push(new Item('获取当前设备类型', getDeviceType))

  }
  build() {    Stack() {      Scroll() {        Column({ space: 5 }) {          ForEach(this.array, (item: Item, index: number) => {            Button(`【${index + 1}】${item.key}`).onClick(() => {              if (item.want instanceof Function) {                item.want(getContext(this))              } else {                const context: common.UIAbilityContext = getContext(this) as common.UIAbilityContext;                context.startAbility(item.want).then(() => {                  console.info('Start successfully.');                }).catch((err: BusinessError) => {                  console.error(`Failed to startAbility. Code: ${err.code}, message: ${err.message}`);                });              }            })          })        }      }      .align(Alignment.Top)      .width('100%')      .height('100%')
      if (this.imageUrl) {        Stack() {          Image(this.imageUrl)            .width('300lpx')            .height('300lpx')            .borderRadius(30)        }.width('100%').height('100%').backgroundColor("#80000000").onClick(() => {          this.imageUrl = undefined        })      }    }.width('100%').height('100%')  }}