创新互联鸿蒙OS教程:鸿蒙OS 接口通用规则

同步

创新互联是一家集网站建设,内江企业网站建设,内江品牌网站建设,网站定制,内江网站建设报价,网络营销,网络优化,内江网站推广为一体的创新建站企业,帮助传统企业提升企业形象加强企业竞争力。可充分满足这一群体相比中小企业更为丰富、高端、多元的互联网需求。同时我们时刻保持专业、时尚、前沿,时刻以成就客户成长自我,坚持不断学习、思考、沉淀、净化自己,让我们为更多的企业打造出实用型网站。

同步方法调用后必须等到方法结果返回后才能继续后续的行为,返回值可以是任意类型。

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

异步

异步方法调用整个过程不会阻碍调用者的工作。业务执行完成后会调用开发者提供的回调函数。

  • 异步接口支持的回调函数
回调函数参数名类型返回值说明
successdataany可选,返回值可以是任意类型,详见接口使用文档。在执行成功时触发。
faildataany错误信息内容,一般是字符串,也可能是其他类型,详见接口使用文档。在执行失败时触发。
codenumber错误代码,详见通用错误码。
canceldataany一般无内容,详见接口使用文档。在用户取消时触发。部分用户交互场景可能有对该回调接口的支持。
complete---在执行完成时触发。

说明

  • success、fail、cancel和complete四个回调函数是否支持参考具体接口描述
  • success、fail和cancel三个回调函数的触发是互斥的,即会且只会在一个回调函数中触发,触发任意一个都会再次调用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);
    },
  });

订阅

订阅接口不会立即返回结果,开发者要在参数中设置相应的回调函数;该回调函数会在完成时或者事件变化时进行回调;可以执行多次。

  • 订阅接口支持以下回调函数
回调函数参数名类型返回值说明
successdataany返回值可以是任意类型,详见接口使用文档。接口调用成功或事件变更时触发,可能会触发多次。
faildataany错误信息内容,一般是字符串,也可能是其他类型,详见接口使用文档。在执行失败时触发。一旦触发该回调函数,success不会再次被调用,接口调用结束。
codenumber错误代码,详见通用错误码。
  • 以地理位置接口为例
  geolocation.subscribe({
    success: function(data) {
      console.log('get location. latitude:' + data.latitude);
    },
    fail: function(data, code) {
      console.log('fail to get location. code:' + code);
    },
  });

网页名称:创新互联鸿蒙OS教程:鸿蒙OS 接口通用规则
文章转载:http://www.shufengxianlan.com/qtweb/news19/400819.html

网站建设、网络推广公司-创新互联,是专注品牌与效果的网站制作,网络营销seo公司;服务项目有等

广告

声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联