更新屏幕广告

1、设备开机1分钟，更新一次数据
2、机柜每20分钟，更新一次数据
3、发送MQTT指令，立即更新一次数据

图片格式

支持：.jpg .png .jpeg

视频格式

1、仅支持：.mp4 (AVC编码)
2、视频分辨率不能大于屏幕尺寸：
例如：视频分辨率->1080x1920,无法在屏幕分辨率->720x1280下正常播放，会卡死或黑屏）
3、可使用HandBrake工具转换格式和分辨率：
https://github.com/HandBrake/HandBrake/releases/tag/1.9.2

指令下发 ▼

订阅主题：/powerbank/{uuid}/user/get

数据格式：JSON字符串

名称	标识代码	数据类型	备注
指令名称	cmd	string	load_ad

更新屏幕广告

{ "cmd":"load_ad" }

设备回复 △

无， 会触发API请求

API请求

请求URL

GET

https://{host}/api/advert/rentbox/distribute/list?uuid=%s&position=%s&sign=%s

/api/advert/rentbox/distribute/list

请求参数

名称	标识代码	是否必填	备注
服务器域名	host	YES	客户提供，例如：s.abc.com
机柜SN	uuid	YES	4G通讯模块，IMEI号
信号值	position	YES	固定值：screen
接口签名	sign	YES	MD5加密

接口签名

sign=MD5("position={position}|uuid={uuid}")

响应结果

{
    "code": 200,
    "type": 0,
    "data": [
        {
            "id": 10000704,
            "title": "",
            "fileType": 0,
            "url1": "",
            "url2": "http://sharingweb.oss-cn-shenzhen.aliyuncs.com/images/325555ec3dcfbe4f640cc910a003a6af.mp4",  // 视频地址
            "playTime": 5,
            "weight": 0,
            "screenBrightness": 255
        },
        {
            "id": 10000702,
            "title": "",
            "fileType": 0,
            "url1": "",
            "url2": "http://sharingweb.oss-cn-shenzhen.aliyuncs.com/images/baebc5a5ce6e7a19ed8b4d0613b0a989.jpg",   // 图片地址
            "playTime": 5,
            "weight": 0,
            "screenBrightness": 255
        },
        {
            "id": 10000701,
            "title": "",
            "fileType": 0,
            "url1": "",
            "url2": "http://sharingweb.oss-cn-shenzhen.aliyuncs.com/images/190bb74bd230b0c6f37f706a70629757.jpg",   // 图片地址
            "playTime": 5,
            "weight": 0,
            "screenBrightness": 255
        }
    ],
    "msg": "OK",
    "time": 1716948821872
}

名称	标识代码	类型	备注
状态码	code	int	默认：200
状态类型	type	int	默认：0
自定义数据	data	json_array	默认：[]
异常消息	msg	string	默认：OK
时间戳	time	long	当前毫秒时间戳

名称	标识代码	类型	备注
编号	id	int	保证唯一
广告标题	title	string	默认：""
文件类型	fileType	int	1图片 2视频
横屏广告地址	url1	string	默认：""
竖屏广告地址	url2	string	默认：""
播放时长	playTime	int	仅限图片有效，设置画面停留时长
排序	weight	int	数值越大，排序靠前
屏幕亮度	screenBrightness	int	范围：0-255