闹钟 1040+

接口声明

  1. { "name": "system.alarm" }

导入模块

  1. import alarm from '@system.alarm' 或 const alarm = require('@system.alarm')

接口定义

alarm.setAlarm (OBJECT)

设置闹钟，每次添加弹出提示框，同意后调用接口添加。

参数

参数名类型必填说明
hourNumber是设置起闹小时[0，23]
minuteNumber是设置起闹分钟[0，59]
messageString否闹钟名,建议长度不超过10字符,以保证最佳显示效果
vibrateBoolean否是否震动，默认true
daysArray否重复周期默认是一次性闹钟[0,1,2,3,4,5,6] 每天[0,1,2,3,4]周一到周五[0,6]（0表示周一 6表示周日）
ringtoneString否默认铃声随系统，文件路径为数据文件或应用内的资源
successFunction否成功回调
failFunction否失败回调
completeFunction否执行结束后的回调（调用成功、失败都会执行）
fail 返回错误代码：
错误码说明
201用户拒绝
202参数错误
300I/O 错误

示例

  1. alarm.setAlarm({
  2.         hour:18,
  3.         minute: 20,
  4.         message: '闹钟1',
  5.         days: [4],
  6.         ringtone: 'internal://mass/test/test.mp3',
  7.         success: function() {
  8.             console.log('handling success')
  9.         },
  10.         fail: function(data, code) {
  11.             console.log(`handling fail, code = ${code}`)
  12.         },
  13.         complete: function() {
  14.             console.log('handling complete')
  15.         }
  16.     }

alarm.getProvider()

获取服务提供商

参数：

无

返回值:

字符串，服务提供商的代号，如厂商的英文品牌名称，假如无此服务则返回空字符串

示例

  1. console.log(alarm.getProvider())

后台运行限制

禁止使用。后台运行详细用法参见后台运行 脚本。