新闻数据

DuerOS提供了新闻类型的内容播报技能,该类技能是对资源数据按照新闻形式进行播报。在这类技能中,开发者仅需将资源按照新闻数据格式的形式提供到DuerOS平台中,无需做其他处理。新闻数据格式的具体内容如下。

数据格式

urlset标签

标签序号 标签名称 标签说明 类型 是否必须
1 urlset 数据的最外层标签。 -
2 url 记录标签,标记每条记录的开始和结束。 -

url标签

标签序号 标签名称 标签说明 类型 是否必须
1 loc 数据存放的url地址。每条数据的loc地址是唯一的,地址长度范围是1~256个字符。该字段不能为空,具体要求参见注意事项 string
2 lastmod 数据的最近一次更新时间。时间的格式为:YYYY-MM-DD[Thh:mm:ss],T是分隔符,[]里面的内容可以不提供。 string
3 changefreq 数据的更新频率。有效值为:
  • always
  • hourly
  • daily
  • weekly
  • monthly
  • yearly
  • never
string
4 priority 当前数据相对比其他数据优先权比值,取值范围是0~1。 double
5 data 数据内容。 -

data标签

标签序号 标签名称 字段说明 类型 是否必须
1 display -
2 action 操作类型。取值类型:
  • add: 添加数据和更新数据。
  • delete:删除数据。
string
3 source_id 资源的id,由资源方提供,每个资源的id唯一。 int
4 source_name 新闻技能创建时分配的技能ID,可以在技能的基础信息中查找到。 string
5 source_type 资源类型,取固定值news。 string
6 update_time 数据更新时间戳。 int
7 cover_url_small 封面小图。 string
8 cover_url_middle 封面中图。 string
9 cover_url_large 封面大图。 string
10 tags 新闻关键词,多个关键词之间使用英文逗号进行隔开。 string
11 title 新闻标题。 string
12 abstract 新闻摘要,长度不超过150个字符。 string
13 content 新闻内容。 string
14 play_url 新闻播放的url地址,支持音频新闻和视频新闻。 string
15 url 新闻详情的url地址,指新闻原网页地址。 string
16 source 新闻来源,如新浪网。 string
17 editor 新闻的编辑,多个编辑之间使用英文逗号进行隔开。 string
18 play_count 点击量或播放量。 int
19 hot 新闻热度,取值范围是0~10。 int
20 duration 播放时间,单位是秒。 int

注意事项

  1. 封面图包含封面小图、封面中图、封面大图三种类型,三种类型的封面图建议至少包含一个,便于在有屏设备上展现。
  2. content和play_url两个标签,至少包含一个。
  3. 每条数据的loc地址是唯一不变的,不同数据的loc地址不能相同,并且loc地址不能为空,长度范围是1~256个字符。如果数据没有loc地址时需要构造loc地址,构造的原则是loc地址=资源文件地址的主域+资源ID号,比如https://www.baidu.com/item/32416https://www.baidu.com/item?id=32416,其中www.baidu.com是主域需要与提交到技能开放平台上的资源文件地址的主域一致,32416是资源ID。
  4. 新闻播报时仅播报title、abstract、play_url三部分,不播报content部分。当没有abstract时,只播报title和play_url部分。

新闻数据的文件

文件要求

  1. 请参照数据格式和举例,将资源写成xml格式的文件。
  2. 请注意数据格式中标签的顺序。同一数据结构中,标签应按照序号由小到大排列。以data数据格式为例,示例如下。
    <data>        
        <display>            
            <action>add</action>                
            <source_id>87345</source_id>                
            <source_name>baidu</source_name>
            <source_type>news</source_type>   
            <update_time>1503845435</update_time>                
            <cover_url_small>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_small>                
            <cover_url_middle>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_middle>                
            <cover_url_large>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_large>                
            <tags>财经,潘石屹</tags>                
            <title>北理莫斯科大学在深圳落成</title>                
            <abstract>北理莫斯科大学在深圳落成</abstract> 
            <content>中国商飞公司今天在第17届北京国际航展上宣布,国产大型喷气式客机C919获得了来自四家航空租赁公司签订的总数130架的新订单。至此,C919的总订单数增加到了730架。</content>                
            <play_url>http://image.kaolafm.net/mz/mp3_32/201610/fa6e54df-283e-4671-97f8-a86bcc70b4ec.mp3</play_url>                
            <url>https://www.baidu.com/home/news/data/newspage?nid=8960533552389139050&amp;n_type=0&amp;p_from=1&amp;dtype=-1</url>                
            <source>新浪网</source>               
            <editor>闫哲</editor>                
            <play_count>357434</play_count>               
            <hot>7</hot>                
        </display>
    </data>

    当可选标签(如cover_url_small、cover_url_middle、tags等标签)缺失时,其他标签按照序号排列的示例如下。

    <data>        
        <display>            
            <action>add</action>                
            <source_id>87345</source_id>                
            <source_name>baidu</source_name>                
            <source_type>news</source_type>                
            <update_time>1503845435</update_time>                
            <cover_url_large>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_large>                
            <title>北理莫斯科大学在深圳落成</title>                
            <abstract>北理莫斯科大学在深圳落成</abstract> 
            <content>中国商飞公司今天在第17届北京国际航展上宣布,国产大型喷气式客机C919获得了来自四家航空租赁公司签订的总数130架的新订单。至此,C919的总订单数增加到了730架。</content>                
            <play_url>http://image.kaolafm.net/mz/mp3_32/201610/fa6e54df-283e-4671-97f8-a86bcc70b4ec.mp3</play_url>                
            <url>https://www.baidu.com/home/news/data/newspage?nid=8960533552389139050&amp;n_type=0&amp;p_from=1&amp;dtype=-1</url>                
            <source>新浪网</source>               
            <editor>闫哲</editor>                
            <play_count>357434</play_count>               
            <hot>7</hot>                
        </display>
    </data>
  3. 文件要求是UTF-8格式,即encoding="UTF-8"
  4. 要求每个文件小于10M,且每个文件中记录不能超过50000条。
  5. 如果文件大于10M,或者记录数超过50000条,请将文件进行拆分,并保证拆分后的每个文件满足上述4个条件。最后将拆分后的文件的URL地址,整理成一个新的文件。 文件拆分过程请参见操作指导
  6. 将文件的URL地址填写到技能开放平台的资源地址中。

举例

<?xml version="1.0" encoding="UTF-8"?>
<urlset>
    <url>
        <loc>http://baidu.com/</loc>
        <lastmod>2013-01-01</lastmod>        
        <changefreq>always</changefreq>        
        <priority>1.0</priority>        
        <data>        
            <display>            
                <action>add</action>                
                <source_id>87345</source_id>                
                <source_name>023e0803-2cd2-93e5-ea84-9fd34852297b</source_name>                
                <source_type>news</source_type>                
                <update_time>1503845435</update_time>                
                <cover_url_small>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_small>                
                <cover_url_middle>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_middle>                
                <cover_url_large>http://fdfs.xmcdn.com/group4/M09/37/FF/wKgDs1QmY-yxmm8QAAC6mL2DXbk334_mobile_small.png</cover_url_large>                
                <tags>财经,潘石屹</tags>                
                <title>北理莫斯科大学在深圳落成</title>                
                <abstract>北理莫斯科大学在深圳落成</abstract>                
                <content>中国商飞公司今天在第17届北京国际航展上宣布,国产大型喷气式客机C919获得了来自四家航空租赁公司签订的总数130架的新订单。至此,C919的总订单数增加到了730架。</content>                
                <play_url>http://image.kaolafm.net/mz/mp3_32/201610/fa6e54df-283e-4671-97f8-a86bcc70b4ec.mp3</play_url>                
                <url>https://www.baidu.com/home/news/data/newspage?nid=8960533552389139050&amp;n_type=0&amp;p_from=1&amp;dtype=-1</url>                
                <source>新浪网</source>               
                <editor>闫哲</editor>                
                <play_count>357434</play_count>               
                <hot>7</hot>                
            </display>
        </data>
    </url>
</urlset>