接口统一的调用异常

报错返回参数：msgCode

名称 描述介绍
服务器开小差了 MTOP 接口的兜底报错
HSF执行错误 HSF 接口没有发布到对应环境
请求API不存在 调用的 mtop 接口不存在
请求参数不正确 参数填写不正确，请查看文档对照参数
（包括，参数类型不正确 和 参数未填写）
除前三个报错信息，剩下的报错，都透传至服务端接口

如何判断当前页面的环境

  1. if (AI.urlParam().type === 'debug' || AI.urlParam().type === 'localDebug') {
  2.     // 预发环境
  3. } else {
  4.     // 线上环境
  5. }

查询食谱推荐列表接口

mtop.alibaba.aicloud.recipe.getRecomandRecipePage

参数

名称 参数类型 是否必须 描述
devId string 是 设备 devId
productKey string 是 设备 productKey
params object 是 主要参数
params.openAccountId string 是 用户账号的 accountId
pageInfo object 否 页码参数
pageInfo.pageNum number 否 当前页码
pageInfo.pageSize number 否 当前页面展示数量

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.getRecomandRecipePage',
  4.     data: {
  5.         devId: 'a80171320100009715c507da78000000', // 获取url上的 AI.devId
  6.         productKey: '306', // 获取url上的 AI.productKey
  7.         params: JSON.stringify({
  8.           openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  9.                     enviroment: 1
  10.         }),
  11.         pageInfo: JSON.stringify({
  12.           pageNum: 1,
  13.           pageSize: 10
  14.         })
  15.     }
  16. }).then((res) => {
  17.     console.log('返回信息', res);
  18. }).catch((res) => {
  19.     console.log('失败返回', res);
  20. });
  22. // 返回数据
  23. {
  24.   "api": "mtop.alibaba.aicloud.recipe.getRecomandRecipePage",
  25.   "data": {
  26.     "success": "true",
  27.     "model": {
  28.       "success": true,
  29.       "retValue": {
  30.         "pageNum": 1, // 第N页
  31.         "pageSize": 10, // 一页条数
  32.         "total": 5, // 总条数
  33.         "list": [
  34.           {
  35.             "contentRecipeId": 1137111, // 内容食谱id
  36.             "recipeName": "开灯1111", // 食谱名
  37.             "collectNum": 0, // 食谱收藏数
  38.             "recipeType": 0, // 食谱类型 0视频菜谱 1图文菜谱
  39.             "description": "xxxdescription111", // 食谱描述
  40.             "functionType": 2, // 功能类型，1 非智能食谱 2智能食谱
  41.             "recipeTime": 0, // 食谱制作时间(秒)
  42.             // 食谱图片地址
  43.             "imageUrl": {
  44.               "img": "www.xxximg111.com", // 默认图片
  45.               "large": "www.xxxlarge111.com", // 大图
  46.               "medium": "www.xxxmedium111.com", // 中图
  47.               "small": "www.xxxsmall111.com" // 小图
  48.             }
  49.           }
  50.         ]
  51.       },
  52.       "extentions": null
  53.     },
  54.     "statusCode": "200"
  55.   }
  56. }

查询菜谱收藏列表接口

mtop.alibaba.aicloud.recipe.getFavoriteRecipeItem

参数

名称 参数类型 是否必须 描述
pageNum number 否 当前页码
pageSize number 否 当前页面展示数量

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.getFavoriteRecipeItem',
  4.     data: {
  5.       pageNum: 1,
  6.       pageSize: 10
  7.     }
  8. }).then((res) => {
  9.     console.log('返回信息', res);
  10. }).catch((res) => {
  11.     console.log('失败返回', res);
  12. });
  14. // 返回数据
  15. {
  16.   "api": "mtop.alibaba.aicloud.recipe.getFavoriteRecipeItem",
  17.   "v": "1.0",
  18.   "ret": [
  19.     "SUCCESS::调用成功"
  20.   ],
  21.   "data": {
  22.     "success": "true",
  23.     "msgCode": "null",
  24.     "msgInfo": "SUCCESS",
  25.     "model": {
  26.       "totalCnt": 2,
  27.       "totalPage": 0,
  28.       "pageNum": 1,
  29.       "pageSize": 10,
  30.       "statusCode": 200,
  31.       "message": null,
  32.       "exception": null,
  33.       "result": [
  34.         {
  35.           "sourceName": null, //源名称
  36.           "recipeType": 1, //食谱类型 0 语音食谱 1 图文食谱
  37.           "tips": "", //小贴士
  38.           "cookTime": null, //制作时长单位秒
  39.           "difficulty": null, //难度
  40.           "cookStepNum": 1, //总部数
  41.           "audioUrl": "这个李子酸看着都会流口水！", //音频地址 图文食谱为描述
  42.           "viewCount": 17000,
  43.           "favorCount": 515,
  44.           "innerfavorCount":0,//内容中心收藏数
  45.           "functionType": 2, // 功能类型，1 非智能食谱 2智能食谱
  46.           "tmjlFavorCount": 173, // 天猫精灵收藏数
  47.                     "intellectRecipe": 1, // 食谱类型（1 普通食谱 2 智能食谱）
  48.           "commentCount": 0,
  49.           "score": null,
  50.           "videoPlayCount": null,
  51.           "cookedCount": 13,
  52.           "dishesCount": 13,
  53.           "rawPageUrl": "https://www.xiachufang.com/recipe/100236532/", //三方连接地址
  54.           "tipsAudioUrl": null,
  55.           "id": 780363, //食谱id
  56.           "rawId": "100236532", //三方id
  57.           "source": "xiachufang", //三方源
  58.           "sourceId": null,
  59.           "title": "开胃李子酸", //食谱名称
  60.           "category": "audio",
  61.           "type": "program",
  62.           "hotScore": null,
  63.           "commCateId": 80027001, //内容分类 80027001 固定 值
  64.           "tppExtendInfo": null,
  65.           "x1Pv30d": 0,
  66.           "x1PvTotal": 0,
  67.           "isCharge": false, //是否收费
  68.           "isAudition": false, //是否试看
  69.           "resourceId": null,
  70.           "description": "这个李子酸看着都会流口水！", //描述
  71.           "offline": false, //是否上线
  72.           "rankLevel": null,
  73.           "videoUrl": null,
  74.           "ingredients": [ //食材
  75.             {
  76.               "name": "紫苏叶（超市有卖）", //名称
  77.               "weight": "1把" // 用量
  78.             }
  79.           ],
  80.           "publishTime": "2014-05-18T14:10:30.000Z", //发布时间
  81.           "tags": [ //标签
  82.             {
  83.               "commonCateId": null,
  84.               "id": 94045, //标签id
  85.               "title": null,
  86.               "alias": null,
  87.               "description": null,
  88.               "isOnline": null,
  89.               "type": "program",
  90.               "tagGroup": null
  91.             }
  92.           ],
  93.           "authors": [ //作者
  94.             {
  95.               "source": null,
  96.               "id": 726699,
  97.               "title": null, //作者名称
  98.               "alias": null,
  99.               "description": null,
  100.               "isOnline": null,
  101.               "type": "program",
  102.               "gender": null,
  103.               "authorTypes": [ //作者类型
  104.                 {
  105.                   "name": "DEFAULT"
  106.                 }
  107.               ],
  108.               "cover": null
  109.             }
  110.           ],
  111.           "itemType": null,
  112.           "valid": null,
  113.           "cover": { //封面
  114.             "img": "https://aicontent.alibabausercontent.com/image-pre/732/732/6cde2c525b3d6a503fbabb5efdb97697.jpg!medium",
  115.             "large": "https://aicontent.alibabausercontent.com/image-pre/732/732/6cde2c525b3d6a503fbabb5efdb97697.jpg!large",
  116.             "mediam": null,
  117.             "medium": "https://aicontent.alibabausercontent.com/image-pre/732/732/6cde2c525b3d6a503fbabb5efdb97697.jpg!medium",
  118.             "small": "https://aicontent.alibabausercontent.com/image-pre/732/732/6cde2c525b3d6a503fbabb5efdb97697.jpg!small"
  119.           },
  120.           "alias": [
  122.           ],
  123.           "releaseTime": null
  124.         }
  125.       ],
  126.       "extentions": null,
  127.       "detail": null
  128.     },
  129.     "statusCode": "200"
  130.   }
  131. }

查询是否收藏了该菜谱

mtop.alibaba.aicloud.recipe.searchDetail

参数

名称 参数类型 是否必须 描述
params object 是 参数对象
params.id string 是 食谱 id

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.searchDetail',
  4.     data: {
  5.         params: JSON.stringify({id: 780368})
  6.     }
  7. }).then((res) => {
  8.     console.log('返回信息', res);
  9. }).catch((res) => {
  10.     console.log('失败返回', res);
  11. });
  13. // 返回数据
  14. {
  15.   "api": "mtop.alibaba.aicloud.recipe.searchDetail",
  16.   "v": "1.0",
  17.   "ret": [
  18.     "SUCCESS::调用成功"
  19.   ],
  20.   "data": {
  21.     "success": "true",
  22.     "msgCode": "success",
  23.     "msgInfo": "SUCCESS",
  24.     "model": {
  25.       "code": 200,
  26.       "message": "success",
  27.       "result": {
  28.         hasFavorite: true // 是否收藏标志
  29.       },
  30.       "extendInfo": null
  31.     },
  32.     "statusCode": "200"
  33.   }
  34. }


收藏or取消收藏操作

mtop.alibaba.aicloud.recipe.favoriteRecipeItem

参数

名称 参数类型 是否必须 描述
contentRecipeIds array 是 菜谱id
isFavorite boolean 是 是否收藏， true 收藏， false 取消收藏

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.favoriteRecipeItem',
  4.     data: {
  5.         contentRecipeIds: JSON.stringify([780368, 780363]),
  6.         isFavorite: true
  7.     }
  8. }).then((res) => {
  9.     console.log('返回信息', res);
  10. }).catch((res) => {
  11.     console.log('失败返回', res);
  12. });
  14. // 返回数据
  15. {
  16.   "api": "mtop.alibaba.aicloud.recipe.favoriteRecipeItem",
  17.   "v": "1.0",
  18.   "ret": [
  19.     "SUCCESS::调用成功"
  20.   ],
  21.   "data": {
  22.     "success": "true",//操作成功标志
  23.     "msgCode": "null",//操作结果码
  24.     "msgInfo": "SUCCESS",//操作结果信息
  25.     "model": {
  26.       "statusCode": 200,
  27.       "message": null,
  28.       "exception": null,//异常信息
  29.       "result": {
  30.         "successIds": [//收藏成功id
  31.           780363,
  32.           780368
  33.         ],
  34.         "failIds": [//收藏失败id
  36.         ]
  37.       },
  38.       "extentions": null,
  39.       "detail": null
  40.     },
  41.     "statusCode": "200"
  42.   }
  43. }

查询食谱关联产品及设备信息接口

mtop.alibaba.aicloud.recipe.getRecipeProductDetailList

参数

名称 参数类型 是否必须 描述
devId string 是 设备 devId
productKey string 是 设备 productKey
params object 是 主要参数
params.openAccountId string 是 用户账号的 accountId
params.contentRecipeId string 是 云食谱Id

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.getRecipeProductDetailList',
  4.     data: {
  5.         devId: AI.devId, // 获取url上的 devId
  6.         productKey: AI.productKey, // 获取url上的 productKey
  7.         params: JSON.stringify({
  8.             openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  9.             contentRecipeId: "779736",
  10.             enviroment: 1 // 环境，1测试，2线上
  11.         })
  12.     }
  13. }).then((res) => {
  14.     console.log('返回信息', res);
  15. }).catch((res) => {
  16.     console.log('失败返回', res);
  17. });
  19. // 返回数据
  20. {
  21.   "api": "mtop.alibaba.aicloud.recipe.getRecipeProductDetailList",
  22.   "data": {
  23.     "success": "true",
  24.     "model": {
  25.       "retCode": 200,
  26.       "success": true,
  27.       "retValue": [
  28.         {
  29.           "contentRecipeId": 779736, // 内容食谱id
  30.           "productKey": "306", // 产品key
  31.           "productName": "智能LED灯泡", // 产品名
  32.           // 产品icon图
  33.           "productIcon": "https://img.alicdn.com/tfs/TB1yQ7cNgHqK1RjSZJnXXbNLpXa-160-160.png",
  34.           "businessRecipeId": 7, // 行业食谱id
  35.           "controlApiName": "alibaba.ailabs.iot.saas.devicecontrol", // 控制接口名
  36.           "deviceStatusApiName": "alibaba.ailabs.iot.saas.deviceStatus", // 设备状态接口名
  37.           "openAccountId": "xxxxx",        // openaccountId
  38.           // 设备列表
  39.           "deviceList": [
  40.             {
  41.               "deviceId": "a80171320100009715c507da78000000" // 设备 Id
  42.             }
  43.           ]
  44.         }
  45.       ],
  46.       "extentions": null
  47.     },
  48.     "statusCode": "200"
  49.   }
  50. }

行业设备控制接口

mtop.alibaba.aicloud.recipe.businessDeviceControl

参数

名称 参数类型 是否必须 描述
devId string 是 设备 devId (h5 sdk 自动填写)
productKey string 是 设备 productKey (h5 sdk 自动填写)
params object 是 主要参数
params.openAccountId string 是 用户账号的 accountId
params.controlApiName string 是 控制接口名
params.releaseStatus number 是 1 预发 2线上
params.domain number 是 1 食谱
params.payload object 是 领域参数

示例
command 指令支持：启动指令 deviceStart，关闭指令 deviceStop，暂停指令 deviceSuspend

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.businessDeviceControl',
  4.     data: {
  5.         devId: AI.devId,
  6.         productKey: AI.productKey,
  7.         params: JSON.stringify({
  8.           openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  9.           controlApiName: "alibaba.ailabs.iot.saas.devicecontrol",
  10.           releaseStatus: 2,
  11.           releaseVersion: null,
  12.           domain: 1,
  13.           payload: JSON.stringify({"businessRecipeId": 100,"command":"deviceStart"})
  14.         })
  15.     }
  16. }).then((res) => {
  17.     console.log('返回信息', res);
  18. }).catch((res) => {
  19.     console.log('失败返回', res);
  20. });
  22. // 返回数据
  23. {
  24.   "api": "mtop.alibaba.aicloud.recipe.businessDeviceControl",
  25.   "data": {
  26.     "success": "true",
  27.     "model": {
  28.       "retCode": 200,
  29.       "success": true,
  30.       "retValue": true, // 是否成功 true 成功  false 失败
  31.       "extentions": null
  32.     },
  33.     "statusCode": "200"
  34.   }
  35. }

错误码：

retCode message
302002 productKey=13414的产品功能定义不支持属性:workSwitch
300003 该账号下没有天猫精灵可以推送指令
302007 设备处于离线状态
302030 音箱不在线,无法推送指令
120010 其他食谱正在制作中
120017 您食谱操作太快了

查询设备食谱制作状态

mtop.alibaba.aicloud.recipe.getDeviceCurrentStatus

参数

名称 参数类型 是否必须 描述
devId string 是 设备 devId (h5 sdk 自动填写)
productKey string 是 设备 productKey (h5 sdk 自动填写)
params object 是 主要参数
params.openAccountId string 是 用户账号的 accountId
params.deviceStatusApiName string 否 设备状态接口名
params.releaseStatus number 是 1 预发 2线上
params.domain number 是 1 食谱
params.payload object 是 领域参数

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.getDeviceCurrentStatus',
  4.     data: {
  5.         devId: AI.devId,
  6.         productKey: AI.productKey,
  7.         params: JSON.stringify({
  8.           openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  9.           deviceStatusApiName: "alibaba.ailabs.iot.saas.deviceStatus",
  10.           releaseStatus: 2,
  11.           releaseVersion: null,
  12.           domain: 1,
  13.           payload: JSON.stringify({"businessRecipeId": 2})
  14.         })
  15.     }
  16. }).then((res) => {
  17.     console.log('返回信息', res);
  18. }).catch((res) => {
  19.     console.log('失败返回', res);
  20. });
  22. // 返回数据
  23. {
  24.   "api": "mtop.alibaba.aicloud.recipe.getDeviceCurrentStatus",
  25.   "data": {
  26.     "success": "true",
  27.     "model": {
  28.       "retCode": 200,                                                                         // 这里返回的是字符串对像，需要先 JSON.parse 一下
  29.       "retValue": {
  30.         "contentRecipeId": 1137111,                                             // 内容食谱id
  31.         "currentContentRecipeStepId": 9420204,                         // 当前食谱步骤id
  32.         "deviceId": "a80171320100009715c507da78000000",     // 设备id
  33.         "runStatus": 1,                                                                     // 运行状态，0 停止 1 运行 2 暂停 3 食谱完成 4 中断暂停
  34.         "totalTimeleft": 180,                                                         // 剩余时间总时间，单位秒
  35.         "productName": "智能LED灯泡",                                          // 产品名称
  36.         "productKey": "306",                                                             // 产品key
  37.         "controlApiName": "alibaba.ailabs.iot.saas.devicecontrol",          // 控制接口名
  38.         "deviceStatusApiName": "alibaba.ailabs.iot.saas.deviceStatus", // 设备状态接口名
  39.         "businessRecipeId": 100,                                                  // 行业食谱id
  40.         "totalTime": 180                                     // 总时间，单位秒
  41.         "deviceStatus": {"name":"start/开始","value":1}         // 设备状态
  42.         "interruptErrorInfo": {"code": 302007,"message":"设备处于离线状态"}    // 中断错误码 
  43.       },
  44.       "extentions": null
  45.     },
  46.     "statusCode": "200"
  47.   }
  48. }

获取云食谱详情接口

mtop.alibaba.aicloud.recipe.listDataRecipeV2

参数

名称 参数类型 是否必须 描述
contentRecipeIds array 是 食谱Id
needStep boolean 是 是否需要获取步骤

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.listDataRecipeV2',
  4.     data: {
  5.         contentRecipeIds: JSON.stringify([779712]),
  6.         needStep: true,
  7.         params: JSON.stringify({
  8.             isProductData: 2 // 2 是线上环境  非2 是预发环境  (默认非2)
  9.         })
  10.     }
  11. }).then((res) => {
  12.     console.log('返回信息', res);
  13. }).catch((res) => {
  14.     console.log('失败返回', res);
  15. });
  17. // 返回数据
  18. {
  19.   "api": "mtop.alibaba.aicloud.recipe.listDataRecipeV2",
  20.   "data": {
  21.     "success": "true"
  22.     "model": {
  23.       "totalSize": 1,                                         // 总数
  24.       "currentPageNum": 0,                                 // 当前页
  25.       "pageSize": 0,                                             // 每页数量
  26.       "success": true,
  27.       "data": [
  28.         {
  29.           "batchId": null,                                 // 批次号
  30.           "id": 779712,                                     // 菜谱的id
  31.           "name": "奶黄水晶饼",                        // 菜谱名称
  32.           "type": 1,                                             // 菜谱类型 0 视频  1 图文
  33.           "tips": null,                                        // 小贴士
  34.           //菜谱描述
  35.           "description": "朋友送了这套小巧玲珑的模具给我正好做可以做水蒸饼，而且花纹也很清晰。",
  36.           "source": "xiachufang",                    // 菜谱来源
  37.           "rawId": "100591900",                        // 外部系统菜谱id
  38.           "cookTime": 0,                                    // 菜谱制作时长 单位秒
  39.           "difficulty": null,                         // 菜谱制作难度
  40.           "firstCommonCateId": 80027,            // 菜谱类型 固定值
  41.           "secCommonCateId": 80027001,        // 菜谱类型 固定值
  42.           "cookStepNum": 9,                                // 菜谱总步数
  43.           "audioUrl": "朋友送了这套小巧玲珑的模具给我正好做可以做水蒸饼，而且花纹也很清晰。",// audio 链接
  44.           "audit": 1,                                            // 审核状态  0 未审核 1 审核中 2 审核通过 3 审核不通过
  45.           "rawPageUrl": "https://www.xiachufang.com/recipe/100591900/",//三方地址链接
  46.           "functionType": 2,                             // 功能类型，1 非智能食谱 2智能食谱
  47.           "steps": [
  48.             {
  49.                 "id": 6455563,                             // 菜谱步骤内部id
  50.               "recipeId": 779712,                  // 菜谱id
  51.               "batchId": null,                         // 批次号
  52.               "name": "1",                                 // 菜谱名称
  53.               "source": "xiachufang",         // 菜谱来源
  54.               "rawId": "1",                             // 三方菜谱步骤id
  55.               "description": "将所有粉类过筛与糖粉混合", // 菜谱步骤描述
  56.               "orderIndex": 1,                         // 菜谱步骤顺序
  57.               "audioUrl": "将所有粉类过筛与糖粉混合", // 菜谱音频地址 没有音频方文字
  58.               "extendInfo": "{\"data_version\":\"2\"}",
  59.               "tips": null,                             // 步骤小贴士
  60.               "recipeRawId": "100591900", // 菜谱三方id
  61.               "tipsAudioUrl": null,
  62.               "operation": null,
  63.               "coverUrl": {                             // 菜谱封面
  64.                 "img": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!medium", // 默认封面
  65.                 "large": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!large", // 大图
  66.                 "mediam": null,
  67.                 "medium": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!medium",// 中图
  68.                 "small": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!small"// 小图
  69.               },
  70.               "videoUrl": {                                // 菜谱步骤视频
  71.                 "cover" : {                                // 封面
  72.                     "img" : "https://aicontent.alibabausercontent.com/image/732/c4c75437005237ab974a7083bed6e348.webp!medium",
  73.                     "large" : "",
  74.                     "mediam" : "",
  75.                     "medium" : "",
  76.                     "small" : ""
  77.                 },
  78.                 "defaultUrl" : "",                // 默认连接
  79.                 "height" : 0,
  80.                 "high" : "",
  81.                 "standard" : "",
  82.                 "ultra" : "",
  83.                 "width" : 0
  84.                }
  85.             }
  86.           ],
  87.           "alias": [
  89.           ],
  90.           "coverUrl": {                                        // 封面
  91.             "img": "https://aicontent.alibabausercontent.com/image-pre/732/732/669a23deebc1f97d34b33f711ef1ec46.jpg!medium",// 默认图片
  92.             "large": "https://aicontent.alibabausercontent.com/image-pre/732/732/669a23deebc1f97d34b33f711ef1ec46.jpg!large",// 大图
  93.             "mediam": null,
  94.             "medium": "https://aicontent.alibabausercontent.com/image-pre/732/732/669a23deebc1f97d34b33f711ef1ec46.jpg!medium",// 中图
  95.             "small": "https://aicontent.alibabausercontent.com/image-pre/732/732/669a23deebc1f97d34b33f711ef1ec46.jpg!small"// 小图
  96.           },
  97.           "videoUrl": null,
  98.           "authorIds": [
  99.             {
  100.               "source": null,
  101.               "id": 726115,                                // 作者id
  102.               "title": "b文惠",                     // 作者名称
  103.               "alias": null,
  104.               "description": null,
  105.               "isOnline": null,
  106.               "type": "program",
  107.               "gender": null,
  108.               "authorTypes": [
  109.                 {
  110.                   "name": "DEFAULT"
  111.                 }
  112.               ],
  113.               "cover": null
  114.             }
  115.           ],
  116.           "tagIds": [
  117.             {
  118.               "commonCateId": null,
  119.               "id": 358242,                                // 标签id
  120.               "title": "饼",                             // 标签名称
  121.               "alias": null,
  122.               "description": null,
  123.               "isOnline": null,
  124.               "type": "program",
  125.               "tagGroup": {
  126.                 "id": 8,                                     // 标签组id
  127.                 "groupName": "测试1",         // 标签组名称
  128.                 "desc": null
  129.               }
  130.             }
  131.           ],
  132.           "ingredient": [                                    // 食材
  133.             {
  134.               "name": "糯米粉",                         // 名称
  135.               "weight": "40克"                         // 用量
  136.             },
  137.             {
  138.               "name": "热开水",
  139.               "weight": "146克"
  140.             },
  141.             {
  142.               "name": "生粉",
  143.               "weight": "20克"
  144.             },
  145.             {
  146.               "name": "植物油",
  147.               "weight": "2汤匙"
  148.             },
  149.             {
  150.               "name": "澄粉",
  151.               "weight": "150克"
  152.             },
  153.             {
  154.               "name": "糖粉",
  155.               "weight": "20克"
  156.             }
  157.           ],
  158.           "online": {
  159.             "name": "ONLINE"
  160.           },
  161.           "copyright": {
  162.             "name": "YES"
  163.           },
  164.           "publishTime": "2015-11-12T23:54:11.000Z"
  165.         }
  166.       ]
  167.     },
  168.     "statusCode": "200"
  169.   }
  170. }

获取云食谱详情步骤列表接口

mtop.alibaba.aicloud.recipe.queryStepsByRecipeIdV2

参数

名称 参数类型 是否必须 描述
contentRecipeId array 是 食谱Id

示例

  1. // 调用示例
  2. AI.aiRequestMtopProxy({
  3.     api: 'mtop.alibaba.aicloud.recipe.queryStepsByRecipeIdV2',
  4.     data: {
  5.         contentRecipeId: 779712,
  6.         params: JSON.stringify({
  7.             isProductData: 2 // 2 是线上环境  非2 是预发环境  (默认非2)
  8.         })
  9.     }
  10. }).then((res) => {
  11.     console.log('返回信息', res);
  12. }).catch((res) => {
  13.     console.log('失败返回', res);
  14. });
  16. // 返回数据
  17. {
  18.   "api": "mtop.alibaba.aicloud.recipe.queryStepsByRecipeIdV2",
  19.   "v": "1.0",
  20.   "ret": [
  21.     "SUCCESS::调用成功"
  22.   ],
  23.   "data": {
  24.     "success": "true",
  25.     "msgCode": "调用成功!",
  26.     "msgInfo": "SUCCESS",
  27.     "model": {
  28.       "totalSize": 9,
  29.       "currentPageNum": 0,
  30.       "pageSize": 0,
  31.       "message": "调用成功!",
  32.       "retCode": 200,
  33.       "success": true,
  34.       "data": [
  35.         {
  36.                 "id": 6455563, //菜谱步骤内部id
  37.               "recipeId": 779712,  //菜谱id
  38.               "batchId": null, //批次号
  39.               "name": "1", //菜谱名称
  40.               "source": "xiachufang", //菜谱来源
  41.               "rawId": "1", //三方菜谱步骤id
  42.               "description": "将所有粉类过筛与糖粉混合", //菜谱步骤描述
  43.               "orderIndex": 1, //菜谱步骤顺序
  44.               "audioUrl": "将所有粉类过筛与糖粉混合", //菜谱音频地址 没有音频方文字
  45.               "extendInfo": "{\"data_version\":\"2\"}",//扩展信息
  46.               "tips": null, //步骤小贴士
  47.               "recipeRawId": "100591900", //菜谱三方id
  48.               "tipsAudioUrl": null,
  49.               "operation": null,
  50.               "coverUrl": { //菜谱封面
  51.                 "img": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!medium", //默认封面
  52.                 "large": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!large", //大图
  53.                 "mediam": null,
  54.                 "medium": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!medium",//中图
  55.                 "small": "https://aicontent.alibabausercontent.com/image-pre/732/732/c625fa544601221f106b905aa69e88e9.webp!small"//小图
  56.               },
  57.               "videoUrl": {//菜谱步骤视频
  58.                 "cover" : {//封面
  59.                     "img" : "https://aicontent.alibabausercontent.com/image/732/c4c75437005237ab974a7083bed6e348.webp!medium",
  60.                     "large" : "",
  61.                     "mediam" : "",
  62.                     "medium" : "",
  63.                     "small" : ""
  64.                 },
  65.                 "defaultUrl" : "",//默认连接
  66.                 "height" : 0,
  67.                 "high" : "",
  68.                 "standard" : "",
  69.                 "ultra" : "",
  70.                 "width" : 0
  71.                }
  72.             }
  73.       ]
  74.     },
  75.     "statusCode": "200"
  76.   }
  77. }

长链接消息推送

  1. AI.deviceStatusChange({
  2.   recipeCallback: resp => {
  3.     console.error('长链接数据返回', resp)
  4.   },
  5.   errorCallback: (error) => { console.log('stateChange ERROR:', error) }
  6. });
  8. // 长链接数据返回
  9. {
  10.   \"traceId\": \"1234567890abcdefghijkl0123456789\",    // 追踪id
  11.   \"timestamp\": 1547714598977,                         // 时间戳
  12.   \"deviceId\": \"456A23FBEB27EDCF4B945094FD92AB0B\",   // 设备Id
  13.   \"domain\": 1,                                        // 领域：1食谱
  14.   \"payload\": {                                        // 领域参数
  15.     \"contentRecipeId\": 100,                           // 内容食谱id
  16.     \"currentContentRecipeStepId\": 9000,               // 当前内容食谱步骤id
  17.     \"runStatus\": 2,                                   // 运行状态，0 停止 1 运行 2 暂停 3 食谱完成 4 中断暂停
  18.     \"timeLeftTotal\": 10,                              // 剩余时间总时间，单位秒
  19.     \"totalTime\": 180,                                 // 总时间，单位秒
  20.     \"productName\": "破壁机",                           // 产品名称
  21.     \"productKey\": \"6001\",                           // 产品key
  22.     \"controlApiName\": \"alibaba.ailabs.iot.saas.devicecontrol\",    // 控制接口名
  23.     \"deviceStatusApiName\": \"alibaba.ailabs.iot.saas.deviceStatus\" // 设备状态接口名
  24.     \"businessRecipeId\": 100,                         // 行业食谱id
  25.     \"deviceStatus\": {\"name\":\"start/开始\",\"value\":1}, // 设备状态
  26.     \"interruptErrorInfo\": {\"code\": 302007,\"message\":\"设备处于离线状态\"} // 中断错误码
  27.   }
  28. }

如下图：云食谱相关长链接返回数据

  1. // 在store/modules/public.js 找到 deviceStatusChange 方法，加上 recipe 逻辑
  2. AI.deviceStatusChange({
  3.     callback: resp => {
  4.         console.log('长链接返回的设备状态：', Object.assign({}, resp.model));
  5.         if (resp.recipe) {
  6.           console.error('recipe', resp) // 云食谱返回数据
  7.           // 注：当云食谱的长链接推送过来，返回的数据在 resp.recipe
  8.           return 
  9.         }
  11.         // 返回的设备状态，是在这个 resp.model 里面的，
  13.     },
  14.     errorCallback: (error) => { console.log('stateChange ERROR:', error) }
  15. });

image.png

获取蓝牙连接状态

  1. AI.getMeshConnestStatus() // 获取蓝牙连接状态   false 未连接   true 已连接

获取音箱列表信息

  1. // 获取列表信息  可根据返回的音箱列表中的 online 判断音箱是否在线
  2. AI.getListDeviceBaseInfoWithStatus().then((res) => {
  3.     console.log('返回信息', res);
  4. }).catch((res) => {
  5.     console.log('失败返回', res);
  6. });

云食谱控制 mesh 设备

  1. // 注：controlInfo 是 调用了 "command":"deviceStart" 获取到的数据
  2. // mtop.alibaba.aicloud.recipe.businessDeviceControl
  4. // 调用示例
  5. AI.controlMeshDevice({
  6.   compareParameters: controlInfo.sigmesh[0].compareParameters,
  7.   action: controlInfo.sigmesh[0].action,
  8.   uuid: controlInfo.sigmesh[0].uuid,
  9.   device: controlInfo.sigmesh[0].device || {}
  10. }).then(resp => {
  11.   AI.cabinet.GenieVue.$toast({ text: 'controlMeshDevice接口成功发送请求' })
  12.   console.log('成功发送请求：' + JSON.stringify(result))
  13. }).catch(err => {
  14.   AI.cabinet.GenieVue.$toast({ text: 'controlMeshDevice接口请求发送失败' })
  15.   console.log('请求发送失败：' + JSON.stringify(err))
  16. })

实战示例

  2. // 启动云食谱
  3. startRecipe() {
  4.   // 调用示例
  5.   AI.aiRequestMtopProxy({
  6.     api: 'mtop.alibaba.aicloud.recipe.businessDeviceControl',
  7.     data: {
  8.       devId: AI.devId,
  9.       productKey: AI.productKey,
  10.       params: JSON.stringify({
  11.         openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  12.         controlApiName: "alibaba.ailabs.iot.saas.devicecontrol",
  13.         releaseStatus: 1,
  14.         releaseVersion: null,
  15.         domain: 1,
  16.         payload: JSON.stringify({"businessRecipeId": this.businessRecipeId || 567,"command":"deviceStart", "pushMethod": 1})
  17.       })
  18.     }
  19.   }).then((res) => {
  20.     console.log('返回信息', res);
  21.     try {
  22.       window.controlInfo = res.data.model.extentions.controlModel[0];
  23.       AI.cabinet.GenieVue.$toast({ text: '启动云食谱成功' + res.data.msgInfo })
  24.     } catch (error) {
  25.       window.controlInfo = {}
  26.       AI.cabinet.GenieVue.$toast({ text: '启动云食谱失败' + res.data.msgInfo })
  27.     }
  28.   }).catch((res) => {
  29.     AI.cabinet.GenieVue.$toast({ text: '启动云食谱失败:' + res.data.msgInfo })
  30.     console.log('失败返回', res);
  31.   });
  32. },
  34.   // 停止云食谱
  35.   stopRecipe() {
  36.     // 调用示例
  37.     AI.aiRequestMtopProxy({
  38.       api: 'mtop.alibaba.aicloud.recipe.businessDeviceControl',
  39.       data: {
  40.         devId: AI.devId,
  41.         productKey: AI.productKey,
  42.         params: JSON.stringify({
  43.           openAccountId: "0yl8oK0WFDBwEheQxSMD4g==",
  44.           controlApiName: "alibaba.ailabs.iot.saas.devicecontrol",
  45.           releaseStatus: 1,
  46.           releaseVersion: null,
  47.           domain: 1,
  48.           payload: JSON.stringify({"businessRecipeId": this.businessRecipeId || 567,"command":"deviceStop", "pushMethod": 1})
  49.         })
  50.       }
  51.     }).then((res) => {
  52.       AI.cabinet.GenieVue.$toast({ text: '停止云食谱成功' + res.data.msgInfo })
  53.       console.log('返回信息', res);
  54.     }).catch((res) => {
  55.       AI.cabinet.GenieVue.$toast({ text: '停止云食谱失败' + res.data.msgInfo })
  56.       console.log('失败返回', res);
  57.     });
  58.   },
  61.     // 云食谱控制mesh设备
  62.     controlMeshDevice() {
  63.       console.log('window.controlInfo', window.controlInfo)
  64.       if (!AI.cabinet.windvaneIsAvailable()) return console.log('请在天猫精灵app上调用controlMeshDevice方法')
  65.       try {
  66.         AI.controlMeshDevice({
  67.           compareParameters: window.controlInfo.sigmesh[0].compareParameters,
  68.           action: window.controlInfo.sigmesh[0].action,
  69.           uuid: window.controlInfo.sigmesh[0].uuid,
  70.           device: window.controlInfo.sigmesh[0].device || {}
  71.         }).then(resp => {
  72.           AI.cabinet.GenieVue.$toast({ text: 'controlMeshDevice接口成功发送请求' })
  73.           console.log('成功发送请求：' + JSON.stringify(result))
  74.         }).catch(err => {
  75.           AI.cabinet.GenieVue.$toast({ text: 'controlMeshDevice接口请求发送失败' })
  76.           console.log('请求发送失败：' + JSON.stringify(err))
  77.         })  
  78.       } catch (error) {
  79.         console.error('控制mesh设备了')
  80.       }
  81.     },