快速開始

本指南將協助您快速上手保利威微信小程式直播播放器SDK，透過一個簡單的範例了解其基本用法。

基本用法

1. 引入SDK

import PolyvLive from '@polyv/wx-live-player-core'

2. 建立播放器實例

播放器類型為PolyvLive，需要傳入設定物件playerConfig。

const player = new PolyvLive(playerConfig)

3. 監聽播放器事件

播放器提供了豐富的事件，您可以透過on方法監聽這些事件。

import { PlayerEventsType } from '@polyv/wx-live-player-core'

// 监听播放器就绪事件
player.on(PlayerEventsType.READY, () => {
  console.log('播放器已就绪')
})

// 监听错误事件
player.on(PlayerEventsType.ERROR, (error) => {
  console.error('播放器错误:', error)
})

4. 初始化播放器

// 初始化播放器
player.setUp()

完整範例

<view>
  <live-player
    wx:if="{{isPlayerShow}}"
    id="live-player"
    src="{{src}}"
  >
  <live-player>
</view>

import PolyvLive, { PlayerEventsType } from '@polyv/wx-live-player-core'

Page({
  data: {
    playerConfig: {
      auth: {
        appId,
        sign,
        timeStamp
      },
      uid,
      cid,
      statistics: {
        param1: 'xxx',
        param2: 'xxx'
      },
    },
    isPlayerShow: false
  },

  onLoad() {
    this.initPlayer()
  },

  initPlayer() {
    const player = new PolyvLive(this.data.playerConfig)

    player.on(PlayerEventsType.READY, () => {
      // 播放器就绪后显示播放器，避免黑屏时间过长
      this.setData({
        isPlayerShow: true
      })
    })

    player.on(PlayerEventsType.UPDATE_MEDIA_INFO, (mediaInfo) => {
      const { type, src } = mediaInfo
      if (type === 'live') {
        this.setData({
          src
        })
      }
    })

    player.on(PlayerEventsType.ERROR, (error) => {
      console.error('播放器错误:', error)
    })

    player.setUp()

    this.player = player
  },

  onUnload() {
    // 页面卸载时释放播放器资源
    if (this.player) {
      this.player.destroy()
    }
  }
})

更多功能

• 檢視完整API文件
• 播放器設定選項
• 了解鑑權設定

注意事項

1. 確保在使用SDK前已完成安裝與設定
2. 播放器事件監聽請在setUp()之前進行綁定
3. 播放器實例會佔用系統資源，在不需要時記得呼叫destroy()方法釋放資源
4. 注意處理播放器的錯誤事件，提供適當的使用者回饋