2_3-快速集成-鸿蒙

1 閱讀準備

請提前下載專案 Demo，並準備好一個 URL，建議使用保利威雲直播/雲點播的觀看端 URL，以體驗更完整的功能。

2 環境需求

3 專案配置

3.1 整合 SDK

請修改模組的 oh-package.json5 檔案，以整合 SDK。

  "dependencies": {
    // WebViewSDK
    "plvwebsdk": "version"
  }

3.2 所需權限

目前 SDK 所需的權限如下：

    "requestPermissions": [
      {
        "name": "ohos.permission.INTERNET"
      },
      {
        "name": "ohos.permission.GET_NETWORK_INFO"
      },
      {
        "name": "ohos.permission.CAMERA",
        "reason": "$string:plv_permission_camera_reason",
        "usedScene": {
          "when": "inuse"
        }
      },
      {
        "name": "ohos.permission.MICROPHONE",
        "reason": "$string:plv_permission_microphone_reason",
        "usedScene": {
          "when": "inuse"
        }
      }
    ]

3.3 頁面跳轉

目前 Demo 提供兩個可跳轉的頁面，分別為：

1. PLVInputPage 為單一 WebView 頁面示範入口頁面，展示單一 WebView 頁面如何進行配置與使用。
2. PLVFeedWebPage 為多個 WebView 頁面示範入口頁面，展示在 Feed 流中使用 WebView 頁面。

您可以根據專案需求，選擇整合使用哪個頁面。

3.4 專案配置

請在 EntryAbility 中配置以下核心程式碼：

export default class PLVEntryAbility extends UIAbility {
    ...
    onWindowStageCreate(windowStage: window.WindowStage): void {
        // demo核心代码, 绑定windowStage
        PLVWebViewWindowManager.setWindowStage(windowStage)
        ....
    }
    
    onForeground(): void {
    // Ability has brought to foreground
    PLVLogger.info(TAG, 'Ability onForeground');
    // demo核心代码
    PLVWebViewWindowManager?.onForeground()
  }

    onBackground(): void {
    // Ability has back to background
    PLVLogger.info(TAG, 'Ability onBackground');
    // demo核心代码
    PLVWebViewWindowManager?.onBackground()
  }
}

請確保在使用小視窗功能前呼叫 PLVWebViewWindowManager.setWindowStage(windowStage)。 小視窗功能需依賴 windowStage 來實現。

3.5 參數修改

Demo 中的參數配置皆在 PLVWebViewConfig 中進行設定，您可以選擇使用的 UA、影片播放位址、是否開啟懸浮視窗等操作。 注意：如果需要到Saas页面的小窗功能的情况，必须在UA中带上Android和PLVUAConfig.defaultUA字段

PLVWebViewConfig()
          .setUrl("https://www.polyv.net") // 设置需要加载Url
          .setUa("Android" + PLVUAConfig.defaultUA) // 设置当前UA
          .setSupportAutoFloating(false) // 设置是否支持自动小窗
          .setAllowFloatingWindow(true) // 设置是否支持开启小窗功能

您可以根據需求進行相應配置。

更多詳細功能請參考完整專案 Demo 來使用。