特效操作

目录

1. 添加特效
2. 更新特效数据
3. 更新特效样式
4. 删除特效

1. 添加特效

引入版本：3.0 起支持

功能描述

在三维场景中添加特效

调用方法

JavaScript

let jsonData = {
  id: '3DMarker',
  coordType: 0,
  coordTypeZ: 0,
  alpha: 1,
  scale: 20,
  type: 'Spread06',
  titleText: '特效06',
  titleColor: '#ffffff',
  titleScale: 1,
  titleBackgroundColor: '#333333',
  tags: ['tag1', 'tag2', 'tag3'],
  coord: [113.92338958000916, 22.507616105668163], //以深圳湾经纬度为例
  coordZ: 100,
  visible: true,
};

appInstance.uniCall('add3DMarker', jsonData, (result) => {
  console.log(result);
});

参数描述

属性	类型	说明	端渲染	流渲染
id	String	模型特效 ID(唯一标识)	支持	支持
coordType	Number	xy 轴坐标模式坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0	支持	支持
coordTypeZ	Number	z 轴坐标模式坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0	支持	支持
alpha	Number	透明度	支持	支持
scale	Number	半径(单位:米)	支持	支持
type	String	样式类型（具体类型参考下图 type 枚举值）	支持	支持
titleText	String	文本标签内容，billboard	支持	支持
titleColor	String	特效标签文本颜色，可选值，默认白色	支持	支持
titleScale	Number	特效标签文本大小，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率	支持	支持
titleBackgroundColor	String	特效标签文本背景颜色，可选值，默认灰色	支持	支持
tags	Array	用户自定标签数组，用于保存用户的扩展数据，或者可以控制显隐	不支持	支持
coord	Array	坐标点 lng,lat	支持	支持
coordZ	Number	高度（米）	支持	支持
visible	Boolean	添加当前图层时默认显示还是隐藏	支持	支持
tag	Anything	用户自定义标签	支持	支持

回调数据

JSON

{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

# type 枚举值

Radar01
Revolve01
Revolve02
Revolve03
Revolve04
Spread01
Spread02
Spread03
Spread04
Spread05
Spread06
Spread07
Spread08
Spread09
Square01
Explosion
Flame

返回本章目录

返回本章目录

2. 更新特效数据

引入版本：3.0 起支持

功能描述

更新三维场景中添加特效的数据

调用方法

JavaScript

let jsonData = {
  id: '3DMarker',
  coordType: 0,
  coordTypeZ: 0,
  coord: [113.92104945588623, 22.511068539824436], //以深圳湾经纬度为例
  coordZ: 150,
  tags: ['tag1', 'tag2', 'tag3'],
};

appInstance.uniCall('update3DMarkerCoord', jsonData, (result) => {
  console.log(result);
});

参数描述

属性	类型	说明	端渲染	流渲染
id	String	模型特效 ID(唯一标识)	支持	支持
coordType	Number	xy 轴坐标模式坐标类型(0:x 经度 y 纬度；1:x 米 y 米，相对世界 00 点) 目前该属性仅支持属性值为 0	支持	支持
coordTypeZ	Number	z 轴坐标模式坐标高度类型，单位：米(0:相对 3D 世界 0 海拔；1:相对 3D 世界地表；2:相对 3D 模型表面) 目前该属性仅支持属性值为 0	支持	支持
tags	Array	用户自定标签数组，用于保存用户的扩展数据，或者可以控制显隐	不支持	支持
coord	Array	坐标点 lng,lat	支持	支持
coordZ	Number	高度（米）	支持	支持
tag	Anything	用户自定义标签	支持	支持

回调数据

JSON

{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录

3. 更新特效样式

引入版本：3.0 起支持

功能描述

更新三维场景中添加特效的样式

调用方法

JavaScript

let jsonData = {
  id: '3DMarker',
  alpha: 1,
  scale: 60,
  type: 'Spread01',
  titleText: '更新特效',
  titleColor: '#ffffff',
  titleScale: 1,
  titleBackgroundColor: '#333333',
};

appInstance.uniCall('update3DMarkerStyle', jsonData, (result) => {
  console.log(result);
});

参数描述

属性	类型	说明
id	String	模型特效 ID(唯一标识)
alpha	Number	透明度
scale	Number	半径(单位:米)
type	String	样式类型（具体类型参考上图 type 枚举值）
titleText	String	文本标签内容，billboard
titleColor	String	特效标签文本颜色，可选值，默认白色
titleScale	Number	特效标签文本大小，默认值是 1 表示原大，0 - 1：表示缩小倍率，大于 1：表示放大倍率
titleBackgroundColor	String	特效标签文本背景颜色，可选值，默认灰色

回调数据

JSON

{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录

4. 删除特效

引入版本：3.0 起支持

功能描述

删除特效

调用方法

JavaScript

let jsonData = {
  id: '3DMarker',
  overlayType: '3DMarker',
};

appInstance.uniCall('removeOverlay', jsonData, (result) => {
  console.log(result);
});

参数描述

属性	类型	说明
id	String	图层对象 id，新建时调用者自己传入的唯一标识，用于各种操作的对象识别
overlayType	String	图层对象类别

回调数据

JSON

{
  "result": 1,
  "message": "成功。"
}

回调数据参数描述

属性	类型	说明
result	Number	1：代表成功；0：代表失败
message	String	成功或者失败原因

返回本章目录