数字人交互 API
共 9 个前端工具方法。
piAlert显示一个警告/提示框输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
msg | String | 是 | — | 要显示的提示信息 |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piAlert",
"value": ["操作成功完成!"]
}
piClient执行客户端操作输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
action | String | 是 | — | 要执行的操作类型 |
ext | Object | 是 | — | 扩展参数对象 |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piClient",
"value": [
"environment.setWeather",
{
"weather": 2
}
]
}
piGoto导航到指定页面输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
pageId | String | 是 | — | 目标页面的ID（可以从 `listV1` 接口查看） |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piGoto",
"value": ["页面ID"]
}
piLink打开指定URL链接输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
url | String | 是 | — | 要打开的URL地址 |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piLink",
"value": ["https://example.com"]
}
piOpenDialog打开指定对话框输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
id | String | 是 | — | 对话框的ID（可以从 `listV1` 接口查看） |
poiId | String | 否 | — | POI ID，非必填。填写之后将根据POI点位移动 |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piOpenDialog",
"value": ["弹窗ID", "poi123"]
}
piToggle切换指定子页面的显示/隐藏状态输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
pageId | String | 是 | — | 要切换的子页面ID（可以从 `listV1` 接口查看，位于 `children` 中） |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piToggle",
"value": ["子页面ID"]
}
piUpdateGlobalParam更新全局参数输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
param | Object | 是 | — | 包含要更新的参数键值对的对象 |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "piUpdateGlobalParam",
"value": [
{
"globalId": "1"
}
]
}
toggleShow切换指定元素的显示状态输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
ids | String` / `Array | 是 | — | 要切换的元素ID或ID数组 |
type | String | 否 | — | 切换类型，默认为 `"toggle"`。可选值：`"show"`、`"hide"`、`"toggle" |
调用
javascript
// eventName: actionEvent
// eventValue:
{
"action": "toggleShow",
"value": ["元素id1", "show"]
}
componentEvent触发指定组件的事件输入
| 参数 | 类型 | 必填 | 默认值 | 说明 |
|---|---|---|---|---|
trigger | String | 是 | — | 触发的事件类型。可选值：`click`、`dblclick`、`mouseenter`、`mouseleave |
id | String | 是 | — | 组件ID |
调用
javascript
// eventName: componentEvent
// eventValue:
{
"action": "componentEvent",
"value": {
"trigger": "click",
"id": "组件id"
}
}