注意：在正式開發前，開發者需要獲取以下參數，否則將無法成功調用。
1、瀏覽視頻方面，在使用小程序過程中，豐富的視頻內容讓用戶更全面、更便捷地了解產品，加速變現效率，幫助品牌獲得更好的曝光機會。
對于同主體或非同主體的情況，開發者都能夠調用接口實現從小程序切換指定的視頻號視頻的效果。
1）前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：channel-video 無彈窗切換至視頻號視頻
<channel-video
feed-id=”yourfeedid” // 視頻 ID
finder-user-name=”yourfindusername” // 視頻號 ID
binderror=”binderror”
></channel-video>
2）前提條件：無主體要求
調用接口：wx.openChannelsActivity 有彈窗切換至視頻號視頻
wx.openChannelsActivity({
feedId: “yourfeedid”, // 視頻 ID
finderUserName: “yourfindusername”, // 視頻號 ID
})
2、參與活動方面，以電商行業為例，商家希望用戶在小程序完成購買流程后，參與官方視頻號的用戶反饋活動，豐富服務內容。此時，通過小程序直接跳轉視頻號活動頁面能夠快速滿足場景需求。
現在，開發者僅需4行代碼即可快速實現小程序切換視頻號活動頁的效果。
前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：wx.openChannelsEvent
wx.openChannelsEvent({
finderUserName: “yourfindusername”, // 視頻號 ID
eventId: “eventid”, // 活動 id，可在「視頻號助手」-「內容管理」-「活動管理」獲取
})
3、預約直播方面，以游戲行業為例，游戲提供方通過小程序打造交流社區，也希望在小程序社區分享游戲直播預告信息，便于用戶及時觀看直播、提升社區活躍度。
現在，開發者直接調用2個接口即可實現在小程序快速預約視頻號直播。
前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：
wx.getChannelsLiveNoticeInfo 獲取直播預告信息
wx.reserveChannelsLive 預約直播
// 獲取視頻號直播預告信息
wx.getChannelsLiveNoticeInfo({
finderUserName: “yourfindusername”, // 視頻號 ID
success(res) {
res.noticeId // 預告 id
res.status // 預告狀態，0: 可用、1: 取消、2: 已用
res.startTime // 開始時間
res.headUrl // 直播封面
res.nickname // 視頻號昵稱
res.reservable // 是否可預約
}
})
// 預約視頻號直播
wx.reserveChannelsLive({
noticeId: “noticeid” // 上面獲取到的直播預告 id
})
4、觀看直播方面，以教育行業為例，用戶在小程序查看產品信息的同時及時通過直播了解到產品詳情，一定程度上提升下單率與復購率。因此，小程序團隊提供3個接口滿足小程序切換視頻號直播的場景需求。
開發者需要注意：直播的不同狀態會導致直接切換至視頻號的承接頁面不同。
現在，開發者可通過 3 個接口實現小程序直接瀏覽視頻號直播的效果。
1）前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：wx.getChannelsLiveInfo 獲取視頻號直播信息
// page.js 獲取視頻號直播信息
wx.getChannelsLiveInfo({
finderUserName: “yourfindusername”, // 視頻號 ID
startTime: “”, // 起始時間
endTime: “”, // 結束時間
success(res) {
res.feedId // 直播 feedId
res.nonceId // 直播 nonceId
res.status // 直播狀態，2: 直播中、3: 直播結束
res.description // 直播主題
res.replayStatus // 視頻號回放狀態，0: 未生成、1: 已生成、3: 生成中、6: 已過期
res.otherInfos // 除最近的一條直播外，其他的直播列表
}
})
2）前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：channel-live 無彈窗切換直播頁面
// page.wxml 視頻號直播組件
<channel-live
feed-id=”yourfeedid” // 直播 feedId
finder-user-name=”yourfindusername” // 視頻號 ID
></channel-live>
3）前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：wx.openChannelsLive 有彈窗切換直播頁面
// 打開視頻直播
wx.openChannelsLive({
finderUserName: “yourfindusername”, // 視頻號 ID
feedId: “livefeedid”, // 上面獲取到的直播 feedId
nonceId: “livenonceid”, // 上面獲取到的直播 nonceId
})
5、查看主頁方面，除了滿足用戶對視頻 /直播內容的需求，微信團隊提供專屬接口直接切換至視頻號主頁，便于用戶快速查看視頻號的所有內容。
開發者僅需 3 行代碼即可快速實現小程序切換視頻號主頁的效果：
前提條件：小程序與視頻號為相同主體或關聯主體
調用接口：wx.openChannelsUserProfile
wx.openChannelsUserProfile({
finderUserName: “yourfindusername” // 視頻號 ID
})
開發者根據不同的應用場景及主體要求，選擇合適的接口 / 組件，滿足用戶的使用體驗。
未來，微信各項能力仍將繼續緊密合作，提供更絲滑的使用體驗，支持更豐富的開發接口，建設更好的生態！
相關內容閱讀：微信小程序接入視頻號直播賣貨操作指引
]]>自 2022 年 10 月 25 日 24 時后（以下統稱 “生效期” ），用戶頭像昵稱獲取規則將進行如下調整：
1、自生效期起，小程序 wx.getUserProfile 接口將被收回：生效期后發布的小程序新版本，通過 wx.getUserProfile 接口獲取用戶頭像將統一返回默認灰色頭像，昵稱將統一返回 “微信用戶”。生效期前發布的小程序版本不受影響，但如果要進行版本更新則需要進行適配。
2、自生效期起，插件通過 wx.getUserInfo 接口獲取用戶昵稱頭像將被收回：生效期后發布的插件新版本，通過 wx.getUserInfo 接口獲取用戶頭像將統一返回默認灰色頭像，昵稱將統一返回 “微信用戶”。生效期前發布的插件版本不受影響，但如果要進行版本更新則需要進行適配。通過 wx.login 與 wx.getUserInfo 接口獲取 openId、unionId 能力不受影響。
3、「頭像昵稱填寫能力」支持獲取用戶頭像昵稱：如業務需獲取用戶頭像昵稱，可以使用「頭像昵稱填寫能力」（基礎庫 2.21.2 版本開始支持），具體實踐可見下方《最佳實踐》。
4、小程序 wx.getUserProfile 與插件 wx.getUserInfo 接口兼容基礎庫 2.21.2 以下版本的頭像昵稱獲取需求：上述「頭像昵稱填寫能力」從基礎庫 2.21.2 版本開始支持（覆蓋微信 8.0.16 以上版本）。對于來自更低版本的基礎庫與微信客戶端的訪問，小程序通過 wx.getUserProfile 接口將正常返回用戶頭像昵稱，插件通過 wx.getUserInfo 接口將返回用戶頭像昵稱，開發者可繼續使用以上能力做向下兼容。
對于上述 3，wx.getUserProfile 接口、wx.getUserInfo 接口、頭像昵稱填寫能力的基礎庫版本支持能力詳細對比見下表：
請已使用 wx.getUserProfile 接口的小程序開發者和已使用 wx.getUserInfo 接口的插件開發者盡快適配。小游戲不受本次調整影響。
]]>微信公眾平臺接口調試工具使用說明最先出現在微信小程序觀察網。
]]>微信接口調試工具通過接口文檔即可一鍵觸達調試工具臺，調試接口很簡單，具有自動生成請求模板、實時顯示調試結果、自動生成代碼片段等特點，省時省力更高效。微信公眾平臺接口調試工具使用說明如下：
1）選擇合適的接口。
2）系統會生成該接口的參數表，您可以直接在文本框內填入對應的參數值。（紅色星號表示該字段必填）
3）點擊檢查問題按鈕，即可得到相應的調試信息。
微信公眾平臺接口調試工具使用說明最先出現在微信小程序觀察網。
]]>FD接口支持一次打開文件，即可進行多次讀/寫的操作。對比原有文件接口每項操作均需要打開、寫入、關閉文件3個步驟，FD接口實現一次打開文件，即可多次讀取、寫入文件，操作完成再關閉文件，減少重復操作。
FD 接口支持只讀/寫文件中指定內容。針對大文件操作場景，FD接口的該項特性能夠減少無效讀寫，降低文件讀寫時間。 如下圖例子，原有文件接口需要全部讀 / 寫內容（如左下圖黃色高亮內容），FD 文件接口則支持只讀 / 寫指定內容（如右下圖黃色高亮內容），降低讀寫耗時。
以連續 100 次讀 + 寫同一個文件 (1MB) 的實驗為例，對比原有接口讀寫文件耗時，FD 接口在安卓端讀寫文件耗時降低 46%，在 iOS 端讀寫耗時降低 19%。
FD接口對比原有文件接口，性能上得到了大幅度的提升，此舉既方便了小程序開發者，又能為用戶帶來更好的使用體驗，未來微信小程序的市場將會更好更廣闊。
]]>常用的微信小程序API接口匯總最先出現在微信小程序觀察網。
]]>微信小程序API接口類型：
1、事件監聽API：以on開頭的API用來監聽某個事件是否觸發。這類API接受一個回調函數作為參數，當事件觸發時會調用這個回調函數，并將相關數據以參數形式傳入。
2、同步API：以Sync結尾的API都是同步API，也有一些其他的同步API。同步API的執行結果可以通過函數返回值直接獲取，如果執行出錯會拋出異常。
3、異步API：大多數API都是異步API。這類API接口通常都接受一個Object類型的參數。異步API的執行結果需要通過Object類型的參數中傳入的對應回調函數獲取。部分異步API也會有返回值，可以用來實現更豐富的功能。
4、云開發API：開通并使用微信云開發，即可使用云開發API，在小程序端直接調用服務端的云函數。
微信小程序API接口匯總：
基礎：
|
名稱 |
功能說明 |
|
wx.env |
環境變量 |
|
wx.canIUse |
判斷小程序的API，回調，參數，組件等是否在當前版本可用 |
|
wx.base64ToArrayBuffer |
將 Base64 字符串轉成 ArrayBuffer 對象 |
| wx.arrayBufferToBase64 |
將 ArrayBuffer 對象轉成 Base64 字符串 |
系統：
|
名稱 |
功能說明 |
|
wx.openSystemBluetoothSetting |
跳轉系統藍牙設置頁 |
|
wx.openAppAuthorizeSetting |
跳轉系統微信授權管理頁 |
|
wx.getWindowInfo |
獲取窗口信息 |
|
wx.getSystemSetting |
獲取設備設置 |
|
wx.getSystemInfoSync |
wx.getSystemInfo 的同步版本 |
|
wx.getSystemInfoAsync |
異步獲取系統信息 |
|
wx.getSystemInfo |
獲取系統信息 |
|
wx.getDeviceInfo |
獲取設備基礎信息 |
|
wx.getAppBaseInfo |
獲取微信APP基礎信息 |
|
wx.getAppAuthorizeSetting |
獲取微信APP授權設置 |
更新：
|
名稱 |
功能說明 |
| wx.updateWeChatApp |
更新客戶端版本 |
|
wx.getUpdateManager |
獲取全局唯一的版本更新管理器，用于管理小程序更新 |
常用的微信小程序API接口匯總最先出現在微信小程序觀察網。
]]>getUserInfo.js
Page({
data: {
userInfo: {},
hasUserInfo: false,
canIUseGetUserProfile: false,
},
onLoad() {
if (wx.getUserProfile) {
this.setData({
canIUseGetUserProfile: true
})
}
},
getUserProfile(e) {
// 推薦使用wx.getUserProfile獲取用戶信息，開發者每次通過該接口獲取用戶個人信息均需用戶確認
// 開發者妥善保管用戶快速填寫的頭像昵稱，避免重復彈窗
wx.getUserProfile({
desc: '用于完善會員資料', // 聲明獲取用戶個人信息后的用途，后續會展示在彈窗中，請謹慎填寫
success: (res) => {
this.setData({
userInfo: res.userInfo,
hasUserInfo: true
})
console.log(res.userInfo)
}
})
},
getUserInfo(e) {
// 不推薦使用getUserInfo獲取用戶信息，預計自2021年4月13日起，getUserInfo將不再彈出彈窗，并直接返回匿名的用戶個人信息
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接口獲取用戶昵稱、頭像具體信息，小程序開發者可以參考官方文檔：https://developers.weixin.qq.com/miniprogram/dev/api/open-api/user-info/wx.getUserProfile.html
]]>選擇群聊天文件接口上線最先出現在微信小程序觀察網。
]]>在各項能力中，黃容特別提到了微信開放接口，其中深受開發者期待的選擇群聊天文件接口終于在近日上線了。
通過「選擇群聊天文件」接口，可讓群文件與小程序更好地打通，可以讓文檔類或有文件溝通場景的小程序更好地做好文件傳輸管理.
這一接口的開放，進一步加強了小程序與微信原生能力的結合，讓「用戶使用小程序，可以更接近使用微信的體驗」。
「選擇群聊天文件」接口現在落地應用的小程序主要是文檔類小程序，包括「微軟 Office 文檔」、「騰訊文檔」等，使用這一功能能夠將微信里的圖片、文件、視頻等導入其中，便于管理微信里的文檔。
接下來，我們將以「微軟 Office 文檔」小程序中的「導入微信文檔」功能為主，為各位介紹「選擇群聊天文件」接口的能力。
打開「微軟 Office 文檔」小程序，點擊左上角的「導入微信文檔」，選擇一個聊天對象（可以是用戶或群聊）后小程序內可快速瀏覽對話中傳輸過的微信文件。
「微軟 Office 文檔」支持導入圖片、音頻、視頻、文件等多種格式文檔，「騰訊文檔」僅支持 doc/docx/xls/xlsx 格式的文件。不過無論是「微軟 Office 文檔」還是「騰訊文檔」小程序，現在的接口在每次導入時僅支持選擇一個文檔。
小程序「微軟 Office 文檔」與「騰訊文檔」使用該接口的界面對比小程序與 OneDrive 綁定，可以將微信中的文檔一鍵同步到 OneDrive 中，也可以選擇「文檔列表」在小程序中隨時隨地瀏覽 OneDrive 中的文檔。
如果你沒有 OneDrive，「微軟 Office 文檔」小程序也提供了一個臨時存儲空間與下載網站 http://aka.ms/officemp，便于在 PC 端下載編輯文檔。而「騰訊文檔」小程序主要支持文檔同步，在 PC 上打開網頁https://docs.qq.com/desktop/可以同步小程序上保存的數據。
顯然，「選擇群聊天文件」接口非常適用于文檔、云盤等小程序，不過目前微信官方文檔并未公布這一接口，只能敬請期待了。
選擇群聊天文件接口上線最先出現在微信小程序觀察網。
]]>