百度智能小程序 配置頁(yè)面基礎(chǔ)信息的接口

swan.setPageInfo

setPageInfo 接口目前只針對(duì)百度 APP 開(kāi)放使用。

配置頁(yè)面基礎(chǔ)信息的接口，目前在 Web 態(tài)代碼和收藏里會(huì)被使用；小程序頁(yè)面被收藏時(shí)，會(huì)用到 setPageInfo 中設(shè)置的頁(yè)面標(biāo)題。setMetaDescription/setMetaKeywords/setDocumentTitle 已停止維護(hù)，推薦使用 setPageInfo 。

建議在 Page 的 onShow 生命周期中使用。由于 onShow 生命周期會(huì)在用戶前進(jìn)后退時(shí)觸發(fā)，若數(shù)據(jù)來(lái)自 onLoad 等其他生命周期，建議使用變量形式存儲(chǔ)并在 onShow 中調(diào)用 setPageInfo 函數(shù)，詳情參見(jiàn)下面的參考示例 1 。

解釋：智能小程序可接入百度搜索和宿主 App 信息流，swan.setPageInfo 負(fù)責(zé)為小程序設(shè)置各類頁(yè)面基礎(chǔ)信息，包括標(biāo)題、關(guān)鍵字、頁(yè)面描述以及圖片信息、視頻信息等。開(kāi)發(fā)者為智能小程序設(shè)置完備的頁(yè)面基礎(chǔ)信息，有助于智能小程序在搜索引擎和信息流中得到更加有效的展示和分發(fā)。其中 title 和 image 字段也增強(qiáng)了用戶添加頁(yè)面收藏的模板展現(xiàn)和回訪體驗(yàn)（用戶可以在小程序菜單中收藏當(dāng)前頁(yè)面，并通過(guò)百度 App “我的-常用功能-收藏”回訪已收藏的頁(yè)面）。

方法參數(shù)

Object object

object參數(shù)說(shuō)明

video 參數(shù)說(shuō)明

visit 參數(shù)說(shuō)明

示例 

在開(kāi)發(fā)者工具中打開(kāi)

圖片示例

代碼示例 1： 

在開(kāi)發(fā)者工具中打開(kāi)

Page({
    onShow() {
        swan.setPageInfo({
            title: '曬元宵節(jié)活動(dòng)紅包，愛(ài)奇藝60張年卡、600張季卡等你拿！-百度貼吧',
            keywords: '百度,百度貼吧,好運(yùn)中國(guó)年,60,曬元,宵節(jié)',
            description: '曬元宵節(jié)活動(dòng)紅包，愛(ài)..昨天的百度APP元宵節(jié)活動(dòng)中，共發(fā)出2億現(xiàn)金紅包、含151萬(wàn)個(gè)手氣現(xiàn)金大獎(jiǎng)和240輛紅旗轎車，誰(shuí)是好運(yùn)錦鯉，快來(lái)分享！馬上驚喜升級(jí)~搖中紅包的錦鯉們即刻曬出紅包金額截圖，我們將會(huì)抽取660位好運(yùn)錦鯉',
            articleTitle: '曬元宵節(jié)活動(dòng)紅包，愛(ài)奇藝60張年卡、600張季卡等你拿！',
            releaseDate: '2019-01-02 12:01:30',
            image: [
                'https://c.hiphotos.baidu.com/forum/w%3D480/sign=73c62dda83b1cb133e693d1bed5456da/f33725109313b07e8dee163d02d7912396dd8cfe.jpg',
                'https://hiphotos.baidu.com/fex/%70%69%63/item/43a7d933c895d143e7b745607ef082025baf07ab.jpg'
            ],
            video: [{
                url: 'https://www.baidu.com/mx/v12.mp4',
                duration: '100',
                image: 'https://smartprogram.baidu.com/docs/img/image-scaleToFill.png'
            }],
            visit: {
                pv: '1000',
                uv: '100',
                sessionDuration: '130'
            },
            likes: '75',
            comments: '13',
            collects: '23',
            shares: '8',
            followers: '35',
            success: res => {
                console.log('setPageInfo success', res);
            },
            fail: err => {
                console.log('setPageInfo fail', err);
            }
        })
    }
});

參考示例

參考示例 1：開(kāi)發(fā)者動(dòng)態(tài)設(shè)置 swan.setPageInfo 字段 
在開(kāi)發(fā)者工具中打開(kāi)

Page({
    onLoad() {
        this.requestTask = new Promise((resolve, reject) => {
            const requestHandler = swan.request({
                url: '開(kāi)發(fā)者服務(wù)器地址',
                header: {
                    'content-type': 'application/json'
                },
                method: 'POST',
                dataType: 'json',
                responseType: 'text',
                data: {
                    key: 'value'
                },
                success: res => {
                    this.setData('data', res.data);
                    resolve();
                },
                fail: err => {
                    console.log('錯(cuò)誤碼：' + err.errCode);
                    console.log('錯(cuò)誤信息：' + err.errMsg);
                }
            });
        });
    },
    onShow() {
        this.requestTask.then( requestData => {
            let res = this.getData('data');
            swan.setPageInfo({
                title: res.title,
                keywords: res.keywords,
                description: res.description,
                articleTitle: res.articleTitle,
                releaseDate: res.releaseDate,
                image: res.image,
                video: res.video,
                visit: res.visit,
                likes: '75',
                comments: '13',
                collects: '23',
                shares: '8',
                followers: '35',
                success: res => {
                    console.log('setPageInfo success');
                },
                fail: err => {
                    console.log('setPageInfo fail', err);
                }
            })
        })
    }
});

Bug & Tip

• releaseData 、 articleTitle 、 image 、 video 、 visit 字段用于宿主 APP 信息流抓取收錄分發(fā)，并有助于搜索準(zhǔn)確理解頁(yè)面內(nèi)容。
• title 字段用于搜索抓取當(dāng)前頁(yè)面，articleTitle 字段用于當(dāng)前頁(yè)面在宿主 APP 信息流中的標(biāo)題展示。
• 當(dāng)前頁(yè)面包含視頻信息時(shí) video 為必填字段， url 、 duration 、 image 為 video 的必填參數(shù)；如當(dāng)前頁(yè)面不包含視頻信息，可不填寫。
• 當(dāng)前頁(yè)面包含焦點(diǎn)圖或者正文圖片時(shí) image 為必填字段。
• 當(dāng)前頁(yè)面能夠統(tǒng)計(jì)到用戶分發(fā)、互動(dòng)和時(shí)長(zhǎng)等數(shù)據(jù)時(shí)，visit 字段建議填寫。開(kāi)發(fā)者可根據(jù)頁(yè)面實(shí)際統(tǒng)計(jì)的情況完善 pv 、 uv 、 sessionDuration 、 likes 、 comments 、 collects 、 shares 、 followers 字段，若頁(yè)面不包含以上字段時(shí)，可不填寫。