快速开始

本指南将帮助您快速上手保利威微信小程序直播播放器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. 注意处理播放器的错误事件，提供适当的用户反馈