鴻蒙OS 接口通用規(guī)則

同步

同步方法調用后必須等到方法結果返回后才能繼續(xù)后續(xù)的行為，返回值可以是任意類型。

• 示例

  var info = app.getInfo();
  console.log(JSON.stringify(info));

異步

異步方法調用整個過程不會阻礙調用者的工作。業(yè)務執(zhí)行完成后會調用開發(fā)者提供的回調函數(shù)。

• 異步接口支持的回調函數(shù)

說明

• success、fail、cancel和complete四個回調函數(shù)是否支持參考具體接口描述

• success、fail和cancel三個回調函數(shù)的觸發(fā)是互斥的，即會且只會在一個回調函數(shù)中觸發(fā)，觸發(fā)任意一個都會再次調用complete回調。

• 使用await異步調用方式，需在JS文件開頭引入@babel/runtime/regenerator，示例如下：

const globalRef = Object.getPrototypeOf(global) || global

// 注入regeneratorRuntime

globalRef.regeneratorRuntime = require('@babel/runtime/regenerator')

• 示例

  battery.getStatus({
    success: function(data) {
      console.log('success get battery level:' + data.level);
    },
    fail: function(data, code) {
      console.log('fail to get battery level code:' + code);
    },
  });

訂閱

訂閱接口不會立即返回結果，開發(fā)者要在參數(shù)中設置相應的回調函數(shù)；該回調函數(shù)會在完成時或者事件變化時進行回調；可以執(zhí)行多次。

• 訂閱接口支持以下回調函數(shù)

• 以地理位置接口為例

  geolocation.subscribe({
    success: function(data) {
      console.log('get location. latitude:' + data.latitude);
    },
    fail: function(data, code) {
      console.log('fail to get location. code:' + code);
    },
  });