Hotpoint

本文档描述此 Feature 的 JSON 数据格式，关于其调用方法，可到此处查看。

Hotpoint Feature 中，飞机会重复地绕着某个指定的 GPS 点（Hot Point）以固定的半径做圆周运动。WIFI 连接模式的 Mavic 以及 Spark 不支持此特性。

JSON 格式

{
	"type": "hotpointFeature",
	"data": {
		"hotpoint": {
			"lat": xxx,
			"lng": xxx,
		}，
			
		// refer to section below
		"startPoint": 0,
		"heading": 0,
			
		// in meters, the range refers to section below
		"altitude": 50, 
			
		// in meters, the range refers to section below
		"radius": 10,
			
		// angular velocity, in degree/s, within range refers to section below,
		// and positive refers to clockwise, vice versa.
		"angularVelocity": 1,
		
		// Refers to section below
		"startAction": actionJson,
		
		// Refers to section below
		"resumeAction": actionJson
	}
}

参数说明

StartPoint

指定飞机从何处开始这次 Hotpoint 的执行。

Type	Description
0	north, 从正北方开始
1	south, 从正南方开始
2	west, 从正西方开始
3	east, 从正东方开始
4	nearest, 从圆形轨道上最靠近飞机当前位置的点开始

Heading

Type	Description
0	alongCircleLookingForward, travel along the circular path.
1	alongCircleLookingBackward, travel along the circular path.
2	towardHotpoint, toward the hot point.
3	awayFromHotpoint, looking away from the hot point.
4	controlledByRemoteController, controlled by the remote controller.
5	usingInitialHeading, the same as the heading of the aircraft when the mission started.

Range of altitude

mesh.featureExecutor.hotpointMinAltitude
mesh.featureExecutor.hotpointMaxAltitude

Range of radius

mesh.featureExecutor.hotpointMinRadius
mesh.featureExecutor.hotpointMaxRadius

Range of velocity

mesh.featureExecutor.hotpointMaxAngularVelocityOfRadius(radius, (mav) => {
	let range = [-mav, mav]
})

startAction

此字段对应的数据为一个 Action 的 JSON，它将会在飞机开始执行 Hotpoint时被调用。

在 Hotpoint 被 Pause/Stop 或者执行完成时，对应的 Action 也会被停止。

resumeAction

此字段对应的数据为一个 Action 的 JSON，它将会在飞机恢复执行 Hotpoint时被调用。

在 Hotpoint 被 Pause/Stop 或者执行完成时，对应的 Action 也会被停止。