1040+{ "name": "system.alarm" }
import alarm from '@system.alarm' 或 const alarm = require('@system.alarm')
设置闹钟，每次添加弹出提示框，同意后调用接口添加。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| hour | Number | 是 | 设置起闹小时[0，23] |
| minute | Number | 是 | 设置起闹分钟[0，59] |
| message | String | 否 | 闹钟名,建议长度不超过 10 字符,以保证最佳显示效果 |
| vibrate | Boolean | 否 | 是否震动，默认 true |
| days | Array | 否 | 重复周期 默认是一次性闹钟 [0,1,2,3,4,5,6] 每天 [0,1,2,3,4]周一到周五 [0,6]（0 表示周一 6 表示周日） |
| ringtone | String | 否 | 默认铃声随系统，文件路径为数据文件或应用内的资源 |
| success | Function | 否 | 成功回调 |
| fail | Function | 否 | 失败回调 |
| complete | Function | 否 | 执行结束后的回调（调用成功、失败都会执行） |
| 错误码 | 说明 |
|---|---|
| 201 | 用户拒绝 |
| 202 | 参数错误 |
203 1120+ | 闹钟能力不可用 |
207 1100+ | 用户拒绝并勾选不再询问复选框 |
| 300 | I/O 错误 |
alarm.setAlarm({
hour:18,
minute: 20,
message: '闹钟1',
days: [4],
ringtone: 'internal://mass/test/test.mp3',
success: function() {
console.log('handling success')
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}, errorMsg=${data}`)
},
complete: function() {
console.log('handling complete')
}
}
获取服务提供商
无
字符串，服务提供商的代号，如厂商的英文品牌名称，假如无此服务则返回空字符串
console.log(alarm.getProvider())
1120+获取闹钟能力可用状态
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | Function | 否 | 成功回调 |
| fail | Function | 否 | 失败回调 |
| complete | Function | 否 | 执行结束后的回调（调用成功、失败都会执行） |
| 参数名 | 类型 | 说明 |
|---|---|---|
| isAvailable | Boolean | true：闹钟能力可用，false：闹钟能力不可用 |
alarm.isAvailable({
success: function(data) {
console.log(`handling success: ${data.isAvailable}`)
},
fail: function(data, code) {
console.log(`handling fail, code = ${code}`)
}
})
禁止使用。
后台运行详细用法参见后台运行 脚本。