智能小程序OPENCARD
开放类目

发布会直播

用户在搜索发布会等需求时，搜索会展现发布会直播卡片，提供实时的发布会现场直播信息。

示意图

intent 上传接口

当前资源 intent 意图参数

key 类型 含义 示例/说明
name string 会议名称 “华为P9手机发布会”

通过平台上传 txt 文件

资源方需要将自己小程序能够覆盖的所有 intent 参数组合通过 txt 文件上传到平台上，txt 文件的具体要求参见接入流程-上传 Intent 数据。

当前资源分类 txt 上传文件内容示例如下：

1
{"name":"华为P9手机发布会"}

通过开放 API 上传

详细接入方式参见 API上传方式

Webhook API

发送给 webhook 的请求

公共字段

key 类型 含义 示例/说明
type string 请求类型 在小程序阿拉丁下永远为 “sp_ala”
surface string 搜索场景 mobile: 支持小程序的移动搜索，web_h5: 支持 H5 的移动搜索
srcid string 资源编号 每个资源分类不同
intent object 搜索意图参数 JSON 对象，每个资源分类不同

当前资源 srcid 资源编号

key 类型 含义 设定
srcid string 资源编号 48002

当前资源的 intent 参数参考上节 “intent 上传接口“。

举例：发送给 webhook 的 JSON (解密后)

1
2
3
4
5
6
7
8
{
  "type": "sp_ala",
  "srcid": "48002",
  "surface": "mobile",
  "intent": {
    "name":"华为P9手机发布会"
  }
}

从 webhook 返回的结果

外层通用数据字段

key 类型 含义 示例/说明
status integer 结果状态码，0 代表正确，1 代表无结果，
2 代表请求参数错误，3 代表内部服务错误		 0
msg string 出错消息，当非 0 时提供 “”
data object 要返回的资源数据内容 JSON 对象，每个资源分类不同

当前资源分类的 data object 字段内容

key 类型 要求 说明
jump_url string 必选 点击卡⽚的跳转路径，例如：/page/of/target
item_list array 必选 发布会直播列表，最少1个，最多3个
item_list.live_image string 必选 发布会图片，分辨率要高于364*486px，比例长：宽=4:3
item_list.live_name string 必选 会议直播名称，尽量<15字，否则会截断,例如“2019百度世界大会“
item_list.live_time string 必选 直播开始的时间，“2019-09-20 14:30:00“
item_list.live_addr string 必选 会议地点，尽量<13字，例如“北京展览馆“
item_list.live_kol string 可选，选后不可为空 会议主讲嘉宾，如果有多个嘉宾，用竖线分隔开
item_list.live_num string 可选，选后不可为空 如果状态为直播中，则动态显示直播在线人数，需要与落地页的实际人数保持一致
item_list.button_text string 可选 按钮文案，直播前不填写，直播中写“观看“，直播完写”回看“
item_list.button_url string 可选 按钮跳转链接，跳转页面需要与文案功能相对应。例如：/page/of/target
item_list.live_state array 必选 直播的状态，建议文案 “未开始／直播中／已结束”，字符串数组，最多3个

举例：从 webhook 返回的 JSON (加密前)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
{
    "status": 0,
    "msg": "string",
    "data": {
        "jump_url": "/page/of/target",
        "item_list": [{
            "live_image": "https://ss0.baidu.com/6ONWsjip0QIZ8tyhnq/it/u=2379086268,2130850456&fm=58",
            "live_name": "华为荣耀V8新品发布会",
            "live_time": "2019-08-30 19:30:00",
            "live_addr": "北京国家会展中心",
            "live_kol": "余承东",
            "live_num": "112345",
            "button_text": "观看",
            "button_url": "/page/of/target",
            "live_state": ["直播中"]
        }]
    }
}

审核常见问题

intent的编写

发布会直播类目intent编写需要符合以下几点要求：

  • intent不需包含“发布会”、“发布会直播”、“直播”等词；
  • intent需精确到产品类型、产品型号或者发布会全称，如“oppo reno2”、“坚果pro3”、“华为开发者大会”，intent不能仅提品牌名或者含义宽泛的产品名和产品型号，如“华为”、“坚果”、“W7”、“手机”等。
影视排行榜 展会门票预订
反 馈帮 助 回 到顶 部