Event

媒体文件上传结果上报

Topic: thing/product/{gateway_sn}/events

Direction: up

Method: file_upload_callback

Data:

Column	Name	Type	constraint	Description
file	文件信息	struct
»object_key	文件在对象存储桶的key	text	{}
»path	文件的业务路径	text	{}
»name	文件的名称	text	{}
»ext	文件扩展内容	struct
»»flight_id	任务id	text	{}
»»drone_model_key	飞机产品枚举值	text	{}
»»payload_model_key	负载产品枚举值	text	{}
»»is_original	是否为原图	bool	{"0":"否","1":"是"}
»metadata	媒体元数据	struct
»»gimbal_yaw_degree	云台偏航角	float	{}
»»absolute_altitude	拍摄绝对高度	float
»»relative_altitude	拍摄相对高度	float
»»created_time	媒体拍摄时间	date	{"format":"iso8601"}
»»shoot_position	拍摄位置	struct	[{"identifier":"lat","name":"拍摄位置纬度","dataType":{"type":"float"}},{"identifier":"lng","name":"拍摄位置经度","dataType":{"type":"float"}}]

Example:

{
	"method": "file_upload_callback",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"need_reply": 1,
	"gateway": "xxx",
	"timestamp:": 1654070968655,
	"data": {
		"file": {
			"object_key": "object_key",
			"path": "xxx",
			"name": "dog.jpeg",
			"ext": {
				"flight_id": "xxx",
				"drone_model_key": "0-67-0",
				"payload_model_key": "0-67-0",
				"is_original": true
			},
			"metadata": {
				"shoot_position": {
					"lat": 22.1,
					"lng": 122.5
				},
				"gimbal_yaw_degree": -91.4,
				"absolute_altitude": 56.311,
				"relative_altitude": 41.124,
				"created_time": "2021-05-10 16:04:20"
			}
		},
		"result": 0
	}
}

媒体文件上传优先级上报

Topic: thing/product/{gateway_sn}/events

Direction: up

Method: highest_priority_upload_flighttask_media

Data:

Column	Name	Type	constraint	Description
flight_id	任务id	text	{}	目前优先级最高的任务id

Example:

{
	"method": "highest_priority_upload_flighttask_media",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"need_reply": 1,
	"gateway": "xxx",
	"timestamp:": 1654070968655,
	"data": {
		"flight_id": "xxx"
	}
}

Service

调整上传的文件为最高优先级

Topic: thing/product/{gateway_sn}/services

Direction: down

Method: upload_flighttask_media_prioritize

Data:

Column	Name	Type	constraint	Description
flight_id	任务id	text	{}	需要最高优先级上传的任务

Example:

{
	"method": "upload_flighttask_media_prioritize",
	"timestamp:": 1654070968655,
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"data": {
		"flight_id": "xxx"
	}
}

Topic: thing/product/{gateway_sn}/services_reply

Direction: up

Method: upload_flighttask_media_prioritize

Data:

Column	Name	Type	constraint	Description
result	返回码	int		非 0 代表错误

Example:

{
	"method": "upload_flighttask_media_prioritize",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp:": 1654070968655,
	"data": {
		"result": 0
	}
}

Requests

获取上传临时凭证

Topic: thing/product/{gateway_sn}/requests

Direction: up

Method: storage_config_get

Data:

Column	Name	Type	constraint	Description
module	模块枚举值	enum	{"0":"媒体"}

Example:

{
	"method": "storage_config_get",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp:": 1654070968655,
	"data": {
		"module": 0
	}
}

Topic: thing/product/{gateway_sn}/requests_reply

Direction: down

Method: storage_config_get

Data:

Column	Name	Type	constraint	Description
bucket	对象存储桶名称	text	{}
credentials	凭证信息	struct
»access_key_id	访问密钥ID	text	{}
»access_key_secret	秘密访问密钥	text	{}
»expire	访问密钥过期时间	int	{"unit":"s","unitName":"秒","step":"1"}
»security_token	会话凭证	text	{}
endpoint	对外服务的访问域名	text	{}
provider	云厂商枚举值	enum	{"ali":"阿里云","aws":"亚马逊云","minio":"minio"}
region	数据中心所在的地域	text	{}
object_key_prefix	对象存储桶的key的前缀	text	{}

Example:

{
	"method": "storage_config_get",
	"bid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"tid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx",
	"timestamp:": 1654070968655,
	"data": {
		"result": 0,
		"output": {
			"bucket": "bucket_name",
			"credentials": {
				"access_key_id": "access_key_id",
				"access_key_secret": "access_key_secret",
				"expire": 3600,
				"security_token": "security_token"
			},
			"endpoint": "https://oss-cn-hangzhou.aliyuncs.com",
			"object_key_prefix": "b4cfaae6-bd9d-4cd0-8472-63b608c3c581",
			"provider": "ali",
			"region": "hz"
		}
	}
}