注意：在正式開發(fā)前，開發(fā)者需要獲取以下參數(shù)，否則將無法成功調(diào)用。

1、瀏覽視頻方面，在使用小程序過程中，豐富的視頻內(nèi)容讓用戶更全面、更便捷地了解產(chǎn)品，加速變現(xiàn)效率，幫助品牌獲得更好的曝光機(jī)會。

對于同主體或非同主體的情況，開發(fā)者都能夠調(diào)用接口實(shí)現(xiàn)從小程序切換指定的視頻號視頻的效果。

1）前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：channel-video 無彈窗切換至視頻號視頻

<channel-video

feed-id=”yourfeedid” // 視頻 ID

finder-user-name=”yourfindusername” // 視頻號 ID

binderror=”binderror”

></channel-video>

2）前提條件：無主體要求

調(diào)用接口：wx.openChannelsActivity 有彈窗切換至視頻號視頻

wx.openChannelsActivity({

feedId: “yourfeedid”, // 視頻 ID

finderUserName: “yourfindusername”, // 視頻號 ID

})

2、參與活動方面，以電商行業(yè)為例，商家希望用戶在小程序完成購買流程后，參與官方視頻號的用戶反饋活動，豐富服務(wù)內(nèi)容。此時，通過小程序直接跳轉(zhuǎn)視頻號活動頁面能夠快速滿足場景需求。

現(xiàn)在，開發(fā)者僅需4行代碼即可快速實(shí)現(xiàn)小程序切換視頻號活動頁的效果。

前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：wx.openChannelsEvent

wx.openChannelsEvent({

finderUserName: “yourfindusername”, // 視頻號 ID

eventId: “eventid”, // 活動 id，可在「視頻號助手」-「內(nèi)容管理」-「活動管理」獲取

})

3、預(yù)約直播方面，以游戲行業(yè)為例，游戲提供方通過小程序打造交流社區(qū)，也希望在小程序社區(qū)分享游戲直播預(yù)告信息，便于用戶及時觀看直播、提升社區(qū)活躍度。

現(xiàn)在，開發(fā)者直接調(diào)用2個接口即可實(shí)現(xiàn)在小程序快速預(yù)約視頻號直播。

前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：

wx.getChannelsLiveNoticeInfo 獲取直播預(yù)告信息

wx.reserveChannelsLive 預(yù)約直播

// 獲取視頻號直播預(yù)告信息

wx.getChannelsLiveNoticeInfo({

finderUserName: “yourfindusername”, // 視頻號 ID

success(res) {

res.noticeId // 預(yù)告 id

res.status // 預(yù)告狀態(tài)，0: 可用、1: 取消、2: 已用

res.startTime // 開始時間

res.headUrl // 直播封面

res.nickname // 視頻號昵稱

res.reservable // 是否可預(yù)約

}

})

// 預(yù)約視頻號直播

wx.reserveChannelsLive({

noticeId: “noticeid” // 上面獲取到的直播預(yù)告 id

})

4、觀看直播方面，以教育行業(yè)為例，用戶在小程序查看產(chǎn)品信息的同時及時通過直播了解到產(chǎn)品詳情，一定程度上提升下單率與復(fù)購率。因此，小程序團(tuán)隊(duì)提供3個接口滿足小程序切換視頻號直播的場景需求。

開發(fā)者需要注意：直播的不同狀態(tài)會導(dǎo)致直接切換至視頻號的承接頁面不同。

現(xiàn)在，開發(fā)者可通過 3 個接口實(shí)現(xiàn)小程序直接瀏覽視頻號直播的效果。

1）前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：wx.getChannelsLiveInfo 獲取視頻號直播信息

// page.js 獲取視頻號直播信息

wx.getChannelsLiveInfo({

finderUserName: “yourfindusername”, // 視頻號 ID

startTime: “”, // 起始時間

endTime: “”, // 結(jié)束時間

success(res) {

res.feedId // 直播 feedId

res.nonceId // 直播 nonceId

res.status // 直播狀態(tài)，2: 直播中、3: 直播結(jié)束

res.description // 直播主題

res.replayStatus // 視頻號回放狀態(tài)，0: 未生成、1: 已生成、3: 生成中、6: 已過期

res.otherInfos // 除最近的一條直播外，其他的直播列表

}

})

2）前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：channel-live 無彈窗切換直播頁面

// page.wxml 視頻號直播組件

<channel-live

feed-id=”yourfeedid” // 直播 feedId

finder-user-name=”yourfindusername” // 視頻號 ID

></channel-live>

3）前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：wx.openChannelsLive 有彈窗切換直播頁面

// 打開視頻直播

wx.openChannelsLive({

finderUserName: “yourfindusername”, // 視頻號 ID

feedId: “livefeedid”, // 上面獲取到的直播 feedId

nonceId: “livenonceid”, // 上面獲取到的直播 nonceId

})

5、查看主頁方面，除了滿足用戶對視頻 /直播內(nèi)容的需求，微信團(tuán)隊(duì)提供專屬接口直接切換至視頻號主頁，便于用戶快速查看視頻號的所有內(nèi)容。

開發(fā)者僅需 3 行代碼即可快速實(shí)現(xiàn)小程序切換視頻號主頁的效果：

前提條件：小程序與視頻號為相同主體或關(guān)聯(lián)主體

調(diào)用接口：wx.openChannelsUserProfile

wx.openChannelsUserProfile({

finderUserName: “yourfindusername” // 視頻號 ID

})

開發(fā)者根據(jù)不同的應(yīng)用場景及主體要求，選擇合適的接口 / 組件，滿足用戶的使用體驗(yàn)。

未來，微信各項(xiàng)能力仍將繼續(xù)緊密合作，提供更絲滑的使用體驗(yàn)，支持更豐富的開發(fā)接口，建設(shè)更好的生態(tài)！

相關(guān)內(nèi)容閱讀：微信小程序接入視頻號直播賣貨操作指引

微信這些接口與組件 讓小程序和視頻號切換更高效便捷最先出現(xiàn)在微信小程序觀察網(wǎng)。

自 2022 年 10 月 25 日 24 時后（以下統(tǒng)稱 “生效期” ），用戶頭像昵稱獲取規(guī)則將進(jìn)行如下調(diào)整：

1、自生效期起，小程序 wx.getUserProfile 接口將被收回：生效期后發(fā)布的小程序新版本，通過 wx.getUserProfile 接口獲取用戶頭像將統(tǒng)一返回默認(rèn)灰色頭像，昵稱將統(tǒng)一返回 “微信用戶”。生效期前發(fā)布的小程序版本不受影響，但如果要進(jìn)行版本更新則需要進(jìn)行適配。

2、自生效期起，插件通過 wx.getUserInfo 接口獲取用戶昵稱頭像將被收回：生效期后發(fā)布的插件新版本，通過 wx.getUserInfo 接口獲取用戶頭像將統(tǒng)一返回默認(rèn)灰色頭像，昵稱將統(tǒng)一返回 “微信用戶”。生效期前發(fā)布的插件版本不受影響，但如果要進(jìn)行版本更新則需要進(jìn)行適配。通過 wx.login 與 wx.getUserInfo 接口獲取 openId、unionId 能力不受影響。

3、「頭像昵稱填寫能力」支持獲取用戶頭像昵稱：如業(yè)務(wù)需獲取用戶頭像昵稱，可以使用「頭像昵稱填寫能力」（基礎(chǔ)庫 2.21.2 版本開始支持），具體實(shí)踐可見下方《最佳實(shí)踐》。

4、小程序 wx.getUserProfile 與插件 wx.getUserInfo 接口兼容基礎(chǔ)庫 2.21.2 以下版本的頭像昵稱獲取需求：上述「頭像昵稱填寫能力」從基礎(chǔ)庫 2.21.2 版本開始支持（覆蓋微信 8.0.16 以上版本）。對于來自更低版本的基礎(chǔ)庫與微信客戶端的訪問，小程序通過 wx.getUserProfile 接口將正常返回用戶頭像昵稱，插件通過 wx.getUserInfo 接口將返回用戶頭像昵稱，開發(fā)者可繼續(xù)使用以上能力做向下兼容。

對于上述 3，wx.getUserProfile 接口、wx.getUserInfo 接口、頭像昵稱填寫能力的基礎(chǔ)庫版本支持能力詳細(xì)對比見下表：

請已使用 wx.getUserProfile 接口的小程序開發(fā)者和已使用 wx.getUserInfo 接口的插件開發(fā)者盡快適配。小游戲不受本次調(diào)整影響。

微信小程序用戶頭像昵稱獲取規(guī)則調(diào)整最先出現(xiàn)在微信小程序觀察網(wǎng)。

微信接口調(diào)試工具通過接口文檔即可一鍵觸達(dá)調(diào)試工具臺，調(diào)試接口很簡單，具有自動生成請求模板、實(shí)時顯示調(diào)試結(jié)果、自動生成代碼片段等特點(diǎn)，省時省力更高效。微信公眾平臺接口調(diào)試工具使用說明如下：

1）選擇合適的接口。

2）系統(tǒng)會生成該接口的參數(shù)表，您可以直接在文本框內(nèi)填入對應(yīng)的參數(shù)值。（紅色星號表示該字段必填）

3）點(diǎn)擊檢查問題按鈕，即可得到相應(yīng)的調(diào)試信息。

微信公眾平臺接口調(diào)試工具使用說明最先出現(xiàn)在微信小程序觀察網(wǎng)。

FD接口支持一次打開文件，即可進(jìn)行多次讀/寫的操作。對比原有文件接口每項(xiàng)操作均需要打開、寫入、關(guān)閉文件3個步驟，F(xiàn)D接口實(shí)現(xiàn)一次打開文件，即可多次讀取、寫入文件，操作完成再關(guān)閉文件，減少重復(fù)操作。

FD 接口支持只讀/寫文件中指定內(nèi)容。針對大文件操作場景，F(xiàn)D接口的該項(xiàng)特性能夠減少無效讀寫，降低文件讀寫時間。 如下圖例子，原有文件接口需要全部讀 / 寫內(nèi)容（如左下圖黃色高亮內(nèi)容），F(xiàn)D 文件接口則支持只讀 / 寫指定內(nèi)容（如右下圖黃色高亮內(nèi)容），降低讀寫耗時。

以連續(xù) 100 次讀 + 寫同一個文件 (1MB) 的實(shí)驗(yàn)為例，對比原有接口讀寫文件耗時，F(xiàn)D 接口在安卓端讀寫文件耗時降低 46%，在 iOS 端讀寫耗時降低 19%。

FD接口對比原有文件接口，性能上得到了大幅度的提升，此舉既方便了小程序開發(fā)者，又能為用戶帶來更好的使用體驗(yàn)，未來微信小程序的市場將會更好更廣闊。

微信新增FD接口 讓小程序讀寫文件更流暢最先出現(xiàn)在微信小程序觀察網(wǎng)。

微信小程序API接口類型：

1、事件監(jiān)聽API：以on開頭的API用來監(jiān)聽某個事件是否觸發(fā)。這類API接受一個回調(diào)函數(shù)作為參數(shù)，當(dāng)事件觸發(fā)時會調(diào)用這個回調(diào)函數(shù)，并將相關(guān)數(shù)據(jù)以參數(shù)形式傳入。

2、同步API：以Sync結(jié)尾的API都是同步API，也有一些其他的同步API。同步API的執(zhí)行結(jié)果可以通過函數(shù)返回值直接獲取，如果執(zhí)行出錯會拋出異常。

3、異步API：大多數(shù)API都是異步API。這類API接口通常都接受一個Object類型的參數(shù)。異步API的執(zhí)行結(jié)果需要通過Object類型的參數(shù)中傳入的對應(yīng)回調(diào)函數(shù)獲取。部分異步API也會有返回值，可以用來實(shí)現(xiàn)更豐富的功能。

4、云開發(fā)API：開通并使用微信云開發(fā)，即可使用云開發(fā)API，在小程序端直接調(diào)用服務(wù)端的云函數(shù)。

微信小程序API接口匯總：

基礎(chǔ)：

系統(tǒng)：

更新：

常用的微信小程序API接口匯總最先出現(xiàn)在微信小程序觀察網(wǎng)。

getUserInfo.js

Page({
data: {
userInfo: {},
hasUserInfo: false,
canIUseGetUserProfile: false,
},
onLoad() {
if (wx.getUserProfile) {
this.setData({
canIUseGetUserProfile: true
})
}
},
getUserProfile(e) {
// 推薦使用wx.getUserProfile獲取用戶信息&#xff0c;開發(fā)者每次通過該接口獲取用戶個人信息均需用戶確認(rèn)
// 開發(fā)者妥善保管用戶快速填寫的頭像昵稱&#xff0c;避免重復(fù)彈窗

wx.getUserProfile({
desc: &#39;用于完善會員資料&#39;, // 聲明獲取用戶個人信息后的用途&#xff0c;后續(xù)會展示在彈窗中&#xff0c;請謹(jǐn)慎填寫
success: (res) &#61;&gt; {
this.setData({
userInfo: res.userInfo,
hasUserInfo: true
})
console.log(res.userInfo)
}
})

},
getUserInfo(e) {

// 不推薦使用getUserInfo獲取用戶信息&#xff0c;預(yù)計(jì)自2021年4月13日起&#xff0c;getUserInfo將不再彈出彈窗&#xff0c;并直接返回匿名的用戶個人信息
console.log(e.detail.userInfo)
this.setData({
userInfo: e.detail.userInfo,
hasUserInfo: true,
})
},
})

getUserInfo.wxml

<view class=”container”>
<view class=”userinfo”>
<block wx:if=”{{!hasUserInfo}}”>
<button wx:if=”{{canIUseGetUserProfile}}” bindtap=”getUserProfile”> 獲取頭像昵稱 </button>
<button wx:else open-type=”getUserInfo” bindgetuserinfo=”getUserInfo”> 獲取頭像昵稱 </button>
</block>
<block wx:else>
<image bindtap=”bindViewTap” class=”userinfo-avatar” src=”{{userInfo.avatarUrl}}” mode=”cover”></image>
<text class=”userinfo-nickname”>{{userInfo.nickName}}</text>
</block>
</view>
</view>

微信小程序wx.getUserProfile接口獲取用戶昵稱、頭像具體信息，小程序開發(fā)者可以參考官方文檔：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserProfile.html

微信小程序wx.getUserProfile接口獲取用戶昵稱、頭像最先出現(xiàn)在微信小程序觀察網(wǎng)。

在各項(xiàng)能力中，黃容特別提到了微信開放接口，其中深受開發(fā)者期待的選擇群聊天文件接口終于在近日上線了。

通過「選擇群聊天文件」接口，可讓群文件與小程序更好地打通，可以讓文檔類或有文件溝通場景的小程序更好地做好文件傳輸管理.

這一接口的開放，進(jìn)一步加強(qiáng)了小程序與微信原生能力的結(jié)合，讓「用戶使用小程序，可以更接近使用微信的體驗(yàn)」。

「選擇群聊天文件」接口現(xiàn)在落地應(yīng)用的小程序主要是文檔類小程序，包括「微軟 Office 文檔」、「騰訊文檔」等，使用這一功能能夠?qū)⑽⑿爬锏膱D片、文件、視頻等導(dǎo)入其中，便于管理微信里的文檔。

接下來，我們將以「微軟 Office 文檔」小程序中的「導(dǎo)入微信文檔」功能為主，為各位介紹「選擇群聊天文件」接口的能力。

打開「微軟 Office 文檔」小程序，點(diǎn)擊左上角的「導(dǎo)入微信文檔」，選擇一個聊天對象（可以是用戶或群聊）后小程序內(nèi)可快速瀏覽對話中傳輸過的微信文件。
「微軟 Office 文檔」支持導(dǎo)入圖片、音頻、視頻、文件等多種格式文檔，「騰訊文檔」僅支持 doc/docx/xls/xlsx 格式的文件。不過無論是「微軟 Office 文檔」還是「騰訊文檔」小程序，現(xiàn)在的接口在每次導(dǎo)入時僅支持選擇一個文檔。

小程序「微軟 Office 文檔」與「騰訊文檔」使用該接口的界面對比小程序與 OneDrive 綁定，可以將微信中的文檔一鍵同步到 OneDrive 中，也可以選擇「文檔列表」在小程序中隨時隨地瀏覽 OneDrive 中的文檔。

如果你沒有 OneDrive，「微軟 Office 文檔」小程序也提供了一個臨時存儲空間與下載網(wǎng)站 http://aka.ms/officemp，便于在 PC 端下載編輯文檔。而「騰訊文檔」小程序主要支持文檔同步，在 PC 上打開網(wǎng)頁https://docs.qq.com/desktop/可以同步小程序上保存的數(shù)據(jù)。

顯然，「選擇群聊天文件」接口非常適用于文檔、云盤等小程序，不過目前微信官方文檔并未公布這一接口，只能敬請期待了。

選擇群聊天文件接口上線最先出現(xiàn)在微信小程序觀察網(wǎng)。