智能小程序 Ray 开发场景 API —— 动作 API 合集

最新推荐文章于 2026-06-25 20:44:04 发布

原创最新推荐文章于 2026-06-25 20:44:04 发布 · 1.1k 阅读

本内容遵循CC 4.0 BY-SA版权协议

标签

#前端 #javascript #开发语言 #API #小程序

创建自动化动作

import { createAction } from '@ray-js/ray';

需引入DeviceKit，且在>=2.5.4版本才可使用

参数

Object object

属性	类型	必填	说明
createType	`string`	是	动作类型:device,smart,remind,delay device:设备 smart:操作某个智能（执行智能、开关自动化） remind:提醒 delay:延时
smartType	`string`	是	智能类型：scene,auto scene:一键执行 auto：自动化
actionArray	`array`	是	当前场景动作列表
complete	`function`	否	接口调用结束的回调函数（调用成功、失败都会执行）
success	`function`	否	接口调用成功的回调函数
fail	`function`	否	接口调用失败的回调函数

object.success 回调参数

参数

Object res

属性	类型	说明
actionArray	`array`	动作列表

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	`string`	插件错误信息
errorCode	`string`	错误码
innerError	`object`	插件外部依赖错误信息 `{errorMsg: string, errorCode: string }`

👉 立即免费领取开发资源，体验涂鸦 MiniApp 小程序开发。

编辑场景动作

import { editAction } from '@ray-js/ray';

需引入DeviceKit，且在>=2.5.4版本才可使用

参数

Object object

SceneAction

属性	类型	默认值	必填	说明
id	string	-		条件 ID
ruleId	string	-		场景 ID
orderNum	number	-		场景 ID
entityId	string	-	✔	条件为设备类型时，表示设备 ID
entityName	string	-		设备名称
actionExecutor	string	-	✔	动作类型。枚举：ruleTrigger、ruleEnable、ruleDisable、appPushTrigger、mobileVoiceSend、smsSend、deviceGroupDpIssue、irIssue、dpIssue、delay、irIssueVii、toggle、dpStep
executorProperty	Record<string, {}>	-		动作执行信息
extraProperty	Record<string, {}>	-		动作额外信息
isDevOnline	boolean	-		设备是否在线
devDelMark	boolean	-		条件为设备类型时，表示设备是否被移除
deleteDevIcon	string	-		条件为设备类型时，表示设备被删除时的图标
devIcon	string	-		条件为设备类型时，设备的图标
actionStrategy	string	-		动作的策略
extraPanelInfo	ExtraPanelInfo	-		面板信息（小程序或者RN面板）
pid	string	-		设备产品 ID
productId	string	-		设备产品 ID
productPic	string	-		条件为设备类型时，表示设备产品图片
defaultIconUrl	string	-		条件默认图标
actionDisplayNew	Record<string, {}>	-		动作展示信息
status	boolean	-		执行状态
relationGroup	Record<string, {}>	-		批量控制设备的数据

object.success 回调参数

参数

Object res

属性	类型	说明
actionArray	`array`	动作列表

object.fail 回调参数

参数

Object res

属性	类型	说明
errorMsg	`string`	插件错误信息
errorCode	`string`	错误码
innerError	`object`	插件外部依赖错误信息 `{errorMsg: string, errorCode: string }`

保存场景动作数据

import { saveSceneAction } from '@ray-js/ray';

需引入DeviceKit，且在>=2.5.4版本才可使用

参数

Object object