保利威文档中心

幫助中心

plv-player-sdk

更新時間：2026-08-14 14:36:53

SDK 版本變更說明

Version 2.11.0

新特性

  1. 新增介面 PLVSetVrmPrivateOsd，可關閉 VRM12/13 預設浮水印，僅支援原生使用

變更與修復

  1. PLVPlayerPlay 介面參數變更，移除過時參數，seekMillisecond 參數含義改為：預設 -1：優先從雲端或本地記憶進度續播，無記憶則從頭播放；≥0：從指定進度開始播放。
  2. PLVPlayerPlayLocal、PLVPlayerLoadLocal 介面 seekMillisecond 參數含義同樣修改

Version 2.10.0

新特性

  1. 支援點播字幕功能
    • 影片載入後支援取得字幕數量與名稱
    • 支援目前字幕取得與設定
    • 支援字幕樣式配置：字型、大小、顏色、邊框大小與顏色、背景顏色、水平垂直對齊方式、垂直位置、是否跟隨視窗縮放、是否可見
    • 支援字幕資訊回呼，可自行渲染
  2. 支援加密影片回源鑑權功能

變更與修復

  1. 刪除下載影片預設畫質時，會將其他畫質一併刪除的問題
  2. 已下載加密影片的播放清單中不再帶有本地路徑資訊

Version 2.9.1

新特性

  1. 支援設定下載限速

變更與修復

  1. 增加 TS 切片斷線重試時間

Version 2.9.0

變更與修復

  1. 修復 VRM13 影片在無快取時無法精確 seek 的問題
  2. 修復因網路重置原因導致播放跳幀或播放結束的問題
  3. 修復下載影片時，因 token 有效性導致暫停後恢復下載失敗的問題
  4. 移除部分無用的依賴庫，降低 SDK 檔案大小

Version 2.8.1

變更與修復

  1. Electron 下硬體防錄製功能不再預設啟用，需要呼叫介面開啟
  2. 點播新增 PLVPlayerSetSeekCacheEnable 介面，用於控制是否基於快取進行 seek

Version 2.8.0

新特性

  1. 支援 MAC 原生 ARM64 架構 SDK

Version 2.7.1

變更與修復

  1. 修復播放轉播頻道直播畫面時，播放啟動速度慢的問題

Version 2.7.0

新特性

  1. 支援頻道直播拉流功能，針對直播播放器有一套新增的介面
  2. 支援虛擬機器環境偵測，目前僅支援 Windows

變更與修復

  1. C++ 介面標記為過時
    1. PLVMigrateLocalVideoKeyFile 建議使用新的 token 介面
    2. PLVPlayerSetAudioDeviceHandler 建議使用 PLVGetAudioDeviceCount 取得音訊裝置列表
    3. PLVPlayerGetAudioDeviceCount 建議使用 PLVGetAudioDeviceCount 取得音訊裝置列表
    4. PLVPlayerGetAudioDeviceInfo 建議使用 PLVGetAudioDeviceInfo 取得音訊裝置資訊
  2. 修復 VRM13 影片在同步播放進度後，無法 seek 到 0-10 秒的問題

Version 2.6.3

變更與修復

  1. 修復弱網情況下，播放器停止時間過長的問題

Version 2.6.2

變更與修復

  1. 記憶進度在影片最後幾秒時，再次播放現在會定位到最前
  2. Elctron-SDK-NAPI 版本 8，建構 node-18.20.3
  3. 修復播放 VRM12、VRM13 線上播放緩衝過低的問題
  4. 修復中文路徑下憑證取得失敗的問題

Version 2.6.1

變更與修復

  1. 相關安全性提升：憑證、日誌、seed 參數防護

Version 2.6.0

新特性

  1. C++ 介面支援自訂播放 seed，僅針對 VRM12|VRM13 的線上播放
  2. C++ 介面新增：PLVPlayerSetAudioPlayErrorHandler，用於音訊播放失敗時回呼通知
  3. Electron 新增：回呼事件 PlayerAudioPlayError，用於音訊播放失敗時回呼通知

變更與修復

  1. C++ 介面標記為過時
    1. PLVAccountInfo 中的 secretKey 與 appSecret 不建議傳入 SDK
    2. PLVSetSdkHttpRequest 不建議呼叫
    3. PLVRequestVideoInfo 建議在伺服器上請求影片資訊
    4. PLVCancelRequestVideoInfo 建議在伺服器上請求影片資訊
    5. PLVPlayerReloadAudioDevice 暫無需呼叫
  2. C++ 介面參數變更
    1. PLVDownloadStart 時，加密影片必須提供 token
  3. Electron 以下介面被移除
    1. setSdkHttpRequest sdk 內部始終以 https 方式請求
    2. requestVideoInfo 建議在伺服器上請求影片資訊
    3. cancelRequestVideoInfo 建議在伺服器上請求影片資訊
    4. playerReloadAudioDevice 暫無需主動重載
  4. Electron 以下介面參數變更
    1. initSdkLibrary 中，不再處理 secretKey 與 appSecret 參數，請不要再傳入
    2. downloadStart 中，加密影片必須提供 token
  5. 音訊變更：WIN32 下不再嘗試使用 openal 播放音訊
  6. 修復 MAC 上結束播放後重新開啟播放有一定機率死結的問題

Version 2.5.3

變更與修復

  1. 修復未釋放 JS 事件相關的問題

Version 2.5.2

變更與修復

  1. 修復 Windows 下播放時，音訊反覆停用與啟用可能導致崩潰的問題
  2. 修復 Windows-Electron 下，硬體防錄製無回呼通知的問題
  3. VRM12、13 浮水印樣式最佳化

Version 2.5.1

變更與修復

  1. 使用 2.3.1 及以下版本下載的離線加密影片，經過 2.4.0 及以上版本遷移機率性失敗的問題
  2. MAC 下主動停止播放未發生停止回呼
  3. VRM12|13 會自帶影片浮水印，無法使用介面去除
  4. Electron-SDK 下硬體防錄製回呼類型錯誤的問題
  5. Electron-SDK 畫質切換不準確問題

Version 2.5.0

介面變更

  1. PLVInitSdkLibrary：增加子帳戶設定
  2. PLVSetSdkLocalRememberPlay：本地續播介面
  3. PLVVideoRequestInfo：影片資訊部分欄位改為 64 位元

新特性

  1. 支援 ECDN 線上播放
  2. 支援跨端續播
  3. 支援使用子帳戶
  4. 支援 Electron 呼叫

變更與修復

  1. 檔案大小顯示不準確
  2. M1 上全螢幕播放有一定機率崩潰
  3. Windows 上使用 WASAPI 播放音訊失敗時嘗試使用 SDL
  4. VRM13 會自帶影片浮水印，無法使用介面去除

Version 2.4.0

遷移說明

  1. 相容性說明：
    • 使用此版本下載的離線影片，不能使用低於此版本的 SDK 進行播放；
    • 不能直接播放低版本的離線影片，必須呼叫此版本的遷移介面進行遷移後才能正常播放；
  2. 遷移說明：
    • 使用此版本時，所有低版本的離線影片都必須遷移；
    • 遷移過程不可逆，也就是遷移後不能使用低版本 SDK 播放；
    • 遷移介面裡的 secretKey 對應下載離線影片時的 secretKey；

變更項目：

  1. 介面及參數類型變更：
    1. plv-player-def.h 變更：
      1. VIDEO_RATE_TYPE；
      2. HDMI_DEVICE_TYPE；
      3. SDK_ERROR_TYPE；
      4. VIDEO_OUTPUT_DEVICE 增加 win 平台限定；
      5. OSDConfigInfo 修改為 PLVOsdConfigInfo，防止重名；
      6. LogoTextInfo 修改為 PLVLogoTextInfo，並去掉 textFontName 參數，防止重名；
      7. 增加類型 VIDEO_REQUEST_TYPE/SOFTWARE_RECORDING_NOTIFY_TYPE；
      8. 增加資料結構 PLVVideoRequestParam/PLVVideoRequestInfo/PLVVideoRequestPageInfo；
    2. plv-player-core.h 變更：
      1. 防錄製介面全部更換，明確區分軟體與硬體防錄製，詳見介面；
      2. 把下載單獨抽取一個檔案 plv-player-download.h：
        1. PLVDownloadSetVideo 變更為 PLVDownloadSetInfo；
        2. PLVDownloadPause 增加參數 pause 決定是否暫停或者恢復；
      3. 播放介面變數：
        1. OnPlayerAudioDeviceHandler 回呼去掉 vid 的回呼；
        2. PLVPlayerSetVideo 變更為 PLVPlayerSetInfo；
        3. PLVPlayerGetRateCount 變更為 PLVPlayerGetCurrentRateCount；
        4. PLVPlayerReloadAudio 變更為 PLVPlayerReloadAudioDevice；
        5. PLVPlayerPlay 增加參數 autoDownRate 用於畫質自動降級；
        6. PLVPlayerPlay 增加參數 playWithToken 用於判斷是否播放時帶上 token；
        7. PLVPlayerPlayLocal 增加參數 autoDownRate 用於畫質自動降級；
        8. PLVPlayerLoadLocal 增加參數 autoDownRate 用於畫質自動降級；
      4. 全域介面：
        1. 新增 PLVSetSdkLogMessageCallback 用於將日誌資訊回呼給上層處理；
        2. 修改 PLVInitSdkLibrary 去掉 readToken 參數；
        3. 新增 PLVRequestVideoInfo 用於請求影片資訊；
        4. 新增 PLVCancelRequestVideoInfo 用於中斷請求影片資訊；
        5. 新增 PLVMigrateLocalVideoKeyFile 用於遷移已經下載的離線影片到新的 key 方案上；
        6. 新增 PLVDeleteLocalVideoFile 用於刪除離線影片；

新特性：

  1. 完善 mac 下防錄製功能；
  2. 增加設定日誌資訊回呼給上層；
  3. 增加請求影片資訊介面；
  4. 增加播放溯源影片參數，playWithToken 為 true；
  5. 增加全域刪除影片介面；
  6. 增加遷移離線影片到新的加密方式上的介面；

修復問題：

  • 【修復】下載暫停時執行緒退出問題；
  • 【修復】跑馬燈在播放中支援修改；
  • 【修復】部分 vrm13 拖動進度時出現影音不同步問題；
  • 【修復】處理 videojson 時，重試的處理邏輯；
  • 【最佳化】vrm12/vrm13 沒有傳 viewerId，返回錯誤碼；
  • 【最佳化】指定 VIDEO_RATE_AUTO 時，使用 videojson 裡預設畫質，不存在時逐級切換，而不是直接使用最低畫質播放；
  • 【最佳化】當影片為原始檔時，下載會判斷是否 MP4 檔案，如果是則下載，並且檔案指定畫質為 LD，為 m3u8 時返回 E_NO_SUPPORT；
  • 【最佳化】最佳化下載解壓失敗時處理邏輯，3 次解壓失敗時會刪除影片重新下載解壓；

Version 2.3.1

修復問題：

  • 【修復】播放 vrm13 離線影片，路徑中包含中文時播放無畫面的問題；

Version 2.3.0

新特性：

  1. 增加介面，支援設定重試下載的次數；

修復問題：

  • 【修改】跑馬燈漸變功能調整，支援淡入淡出；
  • 【最佳化】最佳化網路請求耗時時間；
  • 【最佳化】日誌輸出增加 vid 列印，增加 Debug 級別的內核日誌輸出；
  • 【最佳化】在開始下載前會偵測磁碟空間，如果小於 100M 會返回錯誤碼，下載中失敗會判斷剩餘空間是否小於 10M，如果是回呼返回錯誤碼；

Version 2.2.1

修復問題：

  • 【修復】某些機器下 GDI 渲染模糊問題；
  • 【修改】建立播放器物件時如果傳入視窗句柄為空時返回物件為空；
  • 【修改】MAC 最低支援版本 10.15；

Version 2.2.0

新特性：

  1. 支援 VRM12 播放；
  2. 支援 VRM13 播放；
  3. 減少 MAC 版本依賴庫；
  4. 支援設定 Logo 文字；
  5. 統一跑馬燈與 Logo 文字顏色格式；
  6. 修改播放時跳轉指定時間，只有跳轉完成後才收到載入完成回呼通知；

修復問題：

  • 【功能】增加 GDI 渲染，解決部分機器驅動問題導致播放卡頓問題；
  • 【功能】增加設定憑證路徑介面，解決 https 請求報錯問題；
  • 【功能】修復路徑字元問題，統一 UTF8 字元；
  • 【修改】預設關閉硬體加速，在 VRM13 下硬體加速可能造成花屏；

Version 2.1.0

新特性：

  1. 支援 VRM12 播放；
  2. 支援 MAC 版本；
  3. 支援設定 Logo 文字；

Version 2.0.0

新特性：

  1. 減少依賴庫問題；
  2. 增加 win 防錄製介面回呼；

Version 1.2.0

新特性：

  1. 增加播放緩衝進度回呼；

修復問題：

  • 【功能】VLog 計算錯誤問題；

Version 1.1.0

新特性：

  1. 更新為 C++ 實作；

修復問題：

  • 【功能】某個顯示卡播放影片卡住問題；
联系客服，在线咨询