2_1-快速集成-Android

1 閱讀準備

請預先下載專案 Demo，並準備好一個 URL，建議使用 Polyv 雲直播／雲點播的觀看端 URL，以體驗更完整的功能。

2 環境需求

3 專案設定

3.1 設定支援系統版本

開啟專案模組的 build.gradle 檔案，將 minSdkVersion 改為 17 或更高版本。

3.2 設定 Manifest

開啟專案模組的 AndroidManifest.xml 檔案，新增以下內容：

<?xml version="1.0" encoding="utf-8"?>
<manifest ...>
  <!--网络权限-->
    <uses-permission android:name="android.permission.INTERNET" />
  <!--悬浮小窗-从后台快速恢复到前台-->
    <uses-permission android:name="android.permission.REORDER_TASKS" />
  <!--悬浮小窗-悬浮窗权限-->
    <uses-permission android:name="android.permission.SYSTEM_ALERT_WINDOW" />

    <!--网络状态权限-->
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
    <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />

    <!--连麦权限-->
    <uses-permission android:name="android.permission.CAMERA"/>
    <uses-permission android:name="android.permission.RECORD_AUDIO"/>
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS"/>
    <uses-feature
        android:name="android.hardware.camera"
        android:required="false" />
  
  <!--Android 9及以上系统默认应用禁止Http明文访问，如需要加载http内容，请声明usesCleartextTraffic=true -->
    <application
        ...
        android:usesCleartextTraffic="true"
        android:hardwareAccelerated="true"
        ...>
        ...
    </application>
</manifest>

3.3 設定 maven

開啟專案根目錄的 build.gradle 檔案，新增以下內容：

allprojects {
    repositories {
        google()
        jcenter()
        //添加jitpack仓库
        maven { url "https://jitpack.io" }
        //保利威阿里云效
        maven {
            credentials {
                username '609cc5623a10edbf36da9615'
                password 'EbkbzTNHRJ=P'
            }
            url 'https://packages.aliyun.com/maven/repository/2102846-release-8EVsoM/'
        }
    }
}

4 整合 SDK

在專案模組的 build.gradle 檔案中，新增以下內容：

api 'net.polyv.android:webView:3.2.0' // 3.2.0为具体的SDK版本号

5 程式碼呼叫

透過 PLVWebViewConfig 設定需要載入的 URL 與 UA，再將 PLVWebViewConfig 傳入 PLVWebViewDemoActivity 以載入對應的 Web 頁面，範例程式碼如下：

PLVWebViewConfig config = new PLVWebViewConfig();
config.setUrl("需要加载的url")
        .setUa("需要添加的UA");
PLVWebViewDemoActivity.startWebViewDemoActivity(PLVURLInputActivity.this, config);

目前已在 PLVWebViewBaseActivity 中實作 WebView 管理、小視窗功能等功能，只需建立新的 Activity 繼承該 PLVWebViewBaseActivity 即可完成。

public class PLVWebViewDemoActivity extends PLVWebViewBaseActivity {
    
      public static void startWebViewDemoActivity(Activity activity, PLVWebViewConfig config) {
        Intent intent = new Intent(activity, PLVWebViewDemoActivity.class);
        intent.putExtra(PLV_WEB_VIEW_STATUS_CONFIG, config);
        activity.startActivity(intent);
    }
}

注意：Activity的启动模式需要选择singleTask