保利威雲直播小程式播放外掛

保利威雲直播小程式播放外掛提供了開箱即用的直播播放器，為客戶在小程式端快速接入直播能力提供了有力支持。

前置說明

• 申請使用「Polyv觀看」外掛的小程式需為中國大陸地區的非個人主體。
• 以下類目是「Polyv觀看」外掛當前的准入範圍，不代表微信對所有直播外掛的統一要求。
• 最終是否可以申請和使用外掛，以外掛申請頁面展示及微信審核結果為準。

類目和資質要求詳見Polyv觀看外掛類目申請資質要求。微信外掛通用規則詳見小程式外掛功能介紹和小程式外掛使用說明。

類目不滿足時，可根據實際權限選擇微信小程式直播播放自定義組件。

快速接入

1. 添加外掛

在小程式管理後台的「設定-第三方設定-外掛管理」中添加外掛：

在搜尋欄中輸入外掛AppID或外掛名稱進行搜尋（需要具備相關類目）

• 外掛AppID: wxfb2e591959a8bacf
• 外掛名稱: Polyv观看

添加後，請聯繫您的客戶經理或「保利威」官方客服，申請審核通過。

2. 配置外掛

2.1 在 app.json 中聲明外掛

{
  "plugins": {
    "polyv-live-player": {
      "version": "1.0.2",
      "provider": "wxfb2e591959a8bacf"
    }
  }
}

2.2 在頁面 json 中引入組件

{
  "usingComponents": {
    "polyv-live-player": "plugin://polyv-live-player/live-player"
  }
}

3. 基礎使用示例

3.1 頁面結構 (WXML)

<!-- pages/live/live.wxml -->
<view class="container">
  <polyv-live-player
    config="{{playerConfig}}"
    bind:videoPlay="onVideoPlay"
  />
</view>

3.2 頁面邏輯 (JS)

// pages/live/live.js
Page({
  data: {
    playerConfig: {
      // 鉴权设置
      auth: {
        appId: '',
        sign: '',
        timestamp: xxx
      },
      // 账户信息
      uid: '',
      // 频道信息
      cid: '',
      // 统计信息
      statistics: {
        param1: '',
        param2: ''
      }
    }
  },

  onLoad() {
    console.log('直播页面加载完成');
  },

  // 播放器事件处理
  onVideoPlay() {
    console.log('视频播放事件');
  }
});

畫面填充方式

接入支持 object-fit 的外掛版本後，可在播放器組件上選擇完整顯示或等比裁切鋪滿。預設值為 contain，保持完整顯示；設定為 fillCrop 後，視頻等比鋪滿容器，超出容器的畫面會被裁切。

<polyv-live-player
  config="{{ playerConfig }}"
  object-fit="fillCrop"
/>

object-fit 是組件屬性，不放入 config。該屬性適用於直播、回放和暖場視頻，不影響暖場圖片。動態切換方式及完整參數說明見 object-fit 參數說明。

配置參數

本外掛使用與自定義組件相同的配置參數，詳細參數說明請參考：

• 參數配置文檔 - 完整的參數列表和類型說明
• 事件監聽文檔 - 播放器事件說明
• 接口文檔 - 播放器接口方法

擴展功能

本外掛僅具備視頻播放能力，如需實現以下功能，可參考觀看頁小程式SDK：

• 直播介紹頁面
• 聊天室功能
• 連麥功能
• 更多互動功能

常見問題

為什麼設定 object-fit 後沒有生效？

請確認所引用的外掛版本支持該屬性，並將 object-fit 寫在播放器組件上，而不是寫入 config。本文基礎接入示例中的版本號不代表支持所有新增能力，接入時應選擇已正式發布且支持該屬性的版本。

fillCrop 是否可以去除所有黑邊？

不能保證。該模式會按視頻整體比例縮放並裁切，無法識別視頻源內部已有的黑邊。相關說明見 object-fit 參數說明。