swan.setPageInfo

配置页面基础信息接口，目前在 Web 态代码和收藏里会被使用，推荐使用 setPageInfo；小程序页面被收藏时，会用到setPageInfo中设置的页面标题。

setMetaDescription/setMetaKeywords/setDocumentTitle 已停止维护。

建议在 Page 的 onShow 生命周期中使用。由于onShow 生命周期会在用户前进后退时触发，若数据来自 onLoad 等其他生命周期，建议使用变量形式存储并在 onShow 中调用 setPageInfo 函数，详情参见下面的代码示例二。

解释：智能小程序可接入百度搜索和宿主 App 信息流，swan.setPageInfo 负责为小程序设置各类页面基础信息，包括标题、关键字、页面描述以及图片信息、视频信息等。开发者为智能小程序设置完备的页面基础信息，有助于智能小程序在搜索引擎和信息流中得到更加有效的展示和分发。其中title和image字段也有助于用户添加页面收藏的模板展现和回访体验（用户可以在小程序菜单中收藏当前页面，并通过百度App"我的-常用功能-收藏"回访已收藏的页面）。

方法参数

Object object

object参数说明

属性名类型必填默认值说明
titleString是页面标题
keywordsString是页面关键词，多个关键词之间使用英文逗号“,”隔开
descriptionString是页面描述信息
releaseDateString否（如宿主APP信息流为必填）原始发布时间(年-月-日 时:分:秒 带有前导零）
articleTitleString否文章(内容)标题(适用于当前页面是图文、视频类的展示形式，文章标题需要准确标识当前文章的主要信息点；至少6个字，不可以全英文。)
imageString/Array否（页面有焦点图，或者正文有图片时需要设置）图片线上地址，用于信息流/搜索等流量场景分发、用户收藏后的页面封面显示，展现时有图片可提升用户点击率。开发者可针对一个页面设置最多3张，图片必须为页面内图片。单图片最大2M；封面图尺寸：宽>=375px，高>=250px，图片宽高比例3：2为佳。多张图时，用数组表示。
videoObject/Array否（页面存在视频情况下必填）视频信息，多个视频时，用数组表示
visitObject否浏览信息。最低支持版本3.40.6。
likesString否点赞量，若页面未统计可为空。最低支持版本3.40.6。
commentsString否评论量，若页面未统计可为空。最低支持版本3.40.6。
collectsString否收藏量，若页面未统计可为空。最低支持版本3.40.6。
sharesString否分享量，若页面未统计可为空。最低支持版本3.40.6。
followersString否关注量，若页面未统计可为空。最低支持版本3.40.6。
successFunction否接口调用成功的回调函数
failFunction否接口调用失败的回调函数
completeFunction否接口调用结束的回调函数（调用成功、失败都会执行）

video 参数说明

参数名类型必填说明
urlString是视频地址
durationString是视频时长(单位为秒)
imageString是视频封面图

visit 参数说明

参数名类型必填说明
pvString否页面的浏览量(不去重用户）
uvString否页面的点击量（去重用户）
sessionDurationString否页面的用户人均停留时长，以秒为单位。

示例

扫码体验

请在开发者工具中，单击“预览”，输入您的APPID，单击“WEB预览”，百度APP中扫码体验。

图片示例

swan.setPageInfo - 图1

代码示例 1 ：

在开发者工具中预览效果

在 js 文件中

  1. Page({
  2.     onShow() {
  3.         swan.setPageInfo({
  4.             title: '晒元宵节活动红包，爱奇艺60张年卡、600张季卡等你拿！-百度贴吧',
  5.             keywords: '百度,百度贴吧,好运中国年,60,晒元,宵节',
  6.             description: '晒元宵节活动红包，爱..昨天的百度APP元宵节活动中，共发出2亿现金红包、含151万个手气现金大奖和240辆红旗轿车，谁是好运锦鲤，快来分享！马上惊喜升级~摇中红包的锦鲤们即刻晒出红包金额截图，我们将会抽取660位好运锦鲤',
  7.             articleTitle: '晒元宵节活动红包，爱奇艺60张年卡、600张季卡等你拿！',
  8.             releaseDate: '2019-01-02 12:01:30',
  9.             image: [
  10.                 'https://c.hiphotos.baidu.com/forum/w%3D480/sign=73c62dda83b1cb133e693d1bed5456da/f33725109313b07e8dee163d02d7912396dd8cfe.jpg',
  11.                 'https://hiphotos.baidu.com/fex/%70%69%63/item/43a7d933c895d143e7b745607ef082025baf07ab.jpg'
  12.             ],
  13.             video: [{
  14.                 url: 'https://www.baidu.com/mx/v12.mp4',
  15.                 duration: '100',
  16.                 image: 'https://smartprogram.baidu.com/docs/img/image-scaleToFill.png'
  17.             }],
  18.             visit: {
  19.                 pv: '1000',
  20.                 uv: '100',
  21.                 sessionDuration: '130'
  22.             },
  23.             likes: '75',
  24.             comments: '13',
  25.             collects: '23',
  26.             shares: '8',
  27.             followers: '35',
  28.             success: res => {
  29.                 console.log('setPageInfo success');
  30.             },
  31.             fail: err => {
  32.                 console.log('setPageInfo fail', err);
  33.             }
  34.         })
  35.     }
  36. });

代码示例 2 ：

在开发者工具中预览效果

在 js 文件中

  1. Page({
  2.     onLoad(query) {
  3.         // 当请求依赖于 query 参数时，先从 onLoad 生命周期中取出 query
  4.         this.setData({
  5.             articleID: query.id
  6.         });
  7.     },
  8.     onShow() {
  9.         const articleID = this.getData('articleID');
  10.         swan.request({
  11.             url: `https://example.com/api/article_info?id=${articleID}`,
  12.             success: res => {
  13.                 swan.setPageInfo({
  14.                     title: res.title,
  15.                     keywords: res.keywords,
  16.                     description: res.description,
  17.                     articleTitle: res.articleTitle,
  18.                     releaseDate: res.releaseDate,
  19.                     image: res.image,
  20.                     video: res.video
  21.                 });
  22.             },
  23.             fail: err => {
  24.                 // 异常处理
  25.             }
  26.         });
  27.     }
  28. });

Bug & Tip

  • releaseData、articleTitle、image、video 、visit 内容用于宿主 APP 信息流抓取收录分发，并有助于搜索准确理解页面内容。
  • title字段搜索抓取用于当前页面，articleTitle 字段用于当前页面在宿主APP信息流中的标题展示。
  • 当前页面包含视频信息时 video 为必填字段，url、duration、image为 video 的必填参数；如当前页面不包含视频信息，可不填写。
  • 当前页面包含焦点图或者正文图片 image 为必填字段。
  • 当前页面能够统计到用户分发、互动和时长等数据时，visit字段建议填写。开发者可根据页面实际统计的情况完善pv、uv、sessionDuration、likes、comments、collects、shares、followers字段，若页面不包含以上字段时，可不填写。