微信小程式點播插件防錄屏

適用版本：點播小程式插件 1.19.1 及以上。

功能說明

POLYV 點播小程式插件支援對加密影片預設啟用防錄屏。功能依賴微信提供的螢幕保護能力，在支援的裝置和微信環境中，錄製畫面中的受保護內容會被隱藏，降低影片畫面被錄製傳播的風險。

接入支援該功能的插件版本後，無需新增防錄屏參數。插件根據服務端回傳的影片加密資訊自動判斷是否啟用，一般影片不主動啟用。

使用條件

• 宿主小程式已接入包含防錄屏功能的正式插件版本。使用舊版本的宿主需要更新插件版本並發佈小程式，插件升級不會自動應用到既有宿主。
• 透過影片 vid 播放，且服務端影片資訊標記為加密影片。僅傳入簽名或播放憑證，不代表該影片滿足加密條件；透過自訂位址播放、沒有服務端加密標記的影片不會自動啟用。
• 微信和系統環境滿足下列條件：

微信官方標註該 API 支援小程式插件及鴻蒙 OS 版微信。以上版本條件不代表每台裝置均能達到相同效果，具體適配以微信官方 API 文件和真機表現為準。

使用方法

1. 將宿主小程式使用的點播插件更新到 1.19.1 或以上正式版本。
2. 按原有接入方式傳入加密影片 vid，載入並播放影片，插件自動請求開啟螢幕保護。
3. 使用目標裝置進行錄屏驗證，確認效果後發佈宿主小程式。

暫停加密影片不會自動解除保護。切換一般影片或結束播放場景後，插件按當前播放器狀態更新保護設定。同一頁面存在多個播放器時，只要仍有加密播放器持有保護，一般影片也可能受到螢幕保護影響。

業務結束播放場景時應移除播放器元件。若小程式自身或其他插件也呼叫微信螢幕保護 API，需要由接入方協調設定，避免彼此覆蓋。

驗證方法

1. 在真機上播放加密影片，開啟系統螢幕錄製，分別驗證半螢幕和全螢幕播放。
2. 停止錄製並儲存，到相簿查看錄影，檢查影片畫面是否受到保護。不能僅憑手機播放畫面或 API 成功回呼判斷功能生效。
3. 結束加密影片播放場景，切換一般影片並重新錄製，檢查保護是否解除。測試時確保同頁沒有其他加密播放器仍持有保護。
4. 若業務使用小視窗，補充驗證退出播放頁、關閉小視窗及重新進入一般影片的流程。

使用限制

• 防錄屏屬於微信螢幕能力，不是只覆蓋單一播放器區域的遮罩。
• iOS 目前僅支援錄屏保護，不支援透過該能力阻止截圖。其他系統的截圖效果以微信適配為準。
• 不承諾阻斷錄音或外部裝置拍攝，也不保證所有系統、微信版本和錄製方式都能受到保護。
• 環境不支援或介面呼叫失敗時，插件繼續原有播放流程，不以暫停或禁止播放作為兜底。防錄屏呼叫不會阻塞播放初始化，因此不承諾介面生效前的首幀已受到保護。

常見問題

Q：需要手動開啟防錄屏嗎？

A：不需要。使用支援該功能的插件版本播放服務端標記為加密的影片時，插件預設啟用；一般影片不主動啟用。

Q：為什麼開啟後仍能正常觀看影片？

A：功能針對錄製畫面的表現，正常觀看畫面不能用來判斷保護是否生效。請停止錄製並檢查相簿中儲存的錄影。

Q：為什麼儲存的錄影仍然清晰？

A：先確認宿主實際使用的插件版本、影片加密狀態，以及裝置系統和微信基礎庫版本。滿足條件後仍無效果時，請提供影片 vid、插件版本、手機型號、系統版本、微信版本、基礎庫版本及重現步驟，聯絡技術支援排查。API 回傳成功不等於錄製結果一定受到保護。

Q：一般影片也受到保護，如何處理？

A：先檢查同頁是否仍存在加密播放器，以及小程式自身或其他插件是否設定了螢幕保護。結束加密播放場景後移除對應元件，再驗證一般影片的錄製結果。