本章将为您介绍如何通过SDK接入平台

操作步骤

  1. registerDevice 用于将设备在云端激活并建立链接
    const advert = require('/adsdk/aliyun-iot-ad-sdk');
    advert.registerDevie();
  2. 调用getResource方法,获取广告资源,在设备端进行播放
    getResource 用于获取要播放的广告资源的返回参数说明
    名称 类型 描述 备注
    fileName String 文件名
    matHeight Integer 素材高
    matUrl String 素材地址 素材的下载地址
    expTime Integer 本次请求的广告过期时长(秒)
    errorCode Short 错误代码(0:正常,1:无素材)
    matType Short 素材类型(1:图片,2:视频)
    matWidth Integer 素材宽
    duration Integer 素材播放时长(秒)
    matMd5 String 素材MD5
    winNoticeUrlList List<String> 展示通知URL 素材文件内容MD5编码,用来验证素材下载是否正确
    positionId Long 广告位标识 播放时,需要采用 http get 逐一调用,http code 小于 400 或者等于 408 均为正确。 此接口用于计费(此接口必须在终端设备 上调用),调用时机广告开始播放时调用。
    requestId String 广告请求标识 通请求参数中的requestId
    planId Long 广告计划标识 此值需要在上报播放日志时填入
    channelId Short 渠道ID 此值需要在上报播放日志时填入
    const advert = require('/adsdk/aliyun-iot-ad-sdk');
    advert.getResource().then((res) => {
          console.log(res)
    });
    {
      "fileName": "800&1280.jpg",
      "matHeight": 1280,
      "matUrl": "http://test.yungeshidai.com/material/3222ee7fdca4b2b7ef945901767d178d.jpg",
      "expTime": 1800,
      "errorCode": 0,
      "matType": 1,
      "matWidth": 800,
      "duration": 15,
      "matMd5": "E779E78817768F944F828FF2CD5A8733",
      "winNoticeUrlList": ["http://demo.oohlink.com/website/play/winnotice?p=eH-CrYjmS7SPhq5wB78q8tTTDs6lYiElUpqWoJY4aIumqNcBr3i4GKccU2s66gIuihnqw69G6edFjmI3GwlPbEbwwDfEsEVY4spFnL7eV4mkFHA8NAd1MEG0XlJJsU3jeD6sOP_yJJVB5Zf62r2dSokvRP5dHQA5kIK2RRpxSg2X51nRBsbkiX2Y57JWeNiUAMMg3t2vsGUS916emZYWS0TqAa3vWLl7jwWr4YCsq4ozdYqPQ34yq1hEOBxvoB7t0XzFMc7Tk8wJ4iyJ2HkfXYsO0a38JMmMid7zjD9LNVX50-ULAvJP1nIZau98CPthEZFTcb19fLRCKE1KotUEWIcR_5dhUJ7LCq-Tr02nMy-jUhwFG6-8JXFQsI-5pesXRZiqM1HH_NV5Kv3yvsPN18-88OoRmdmFRsnbpLFE3zM5oqh1pv0ZGhIw2hm0Ou5P4o2Dwbmd5oxaj3BQnZW-GpGXP2qww13kEa6Y5WiuX9Ro_YsB9KIIQqTe7DyHEXd41ElmSg1zkLVjwhrOxpKltl9srSXTkvLYvisCrBr7-yQ"],
      "positionId": 109550,
      "requestId": "e7b788a9-ca96-4d1c-beab-56563fd",
      "planId": 471,
      "channelId": 0
    }
    现在只支持保存一条广告资源,多次获取资源只会保留最新一次数据资源winNoticeUrlList,adTrackList, 是存放的监控播放上报地址,在调用开始播放时,会向监控播放地址发起请求planId,requestId,channelId,matUrl,fileName,matType,duration,是广告资源的基础属性,会在日志上报中使用
  3. 在设备开始播放广告资源时,调用 startPlayNotification 向广告方推送开始播放日志
    startPlayNotification 播放时调用此方法,用于记录资源开始播放时间
    const advert = require('/adsdk/aliyun-iot-ad-sdk');
    advert.startPlayNotification();
  4. 在设备端停止播放广告资源时,调用 endPlayNotification 向广告方推送结束播放日志
    endPlayNotification 播放结束时调用此方法,用于资源播放结束时,向云端上报日志
    const advert = require('/adsdk/aliyun-iot-ad-sdk');
    advert.endPlayNotification();