體驗Demo

環境要求

前提條件

下載Android播放器SDK包（包含了播放器SDK及Demo源碼），推薦下載使用最新版本。下載地址請參見SDK簡介與下載。

運行完整Demo（含內置UI）

通過導入完整的播放器SDK Demo包，可不再單獨集成SDK，直接開始使用包含了內置UI的播放器功能。

集成Demo模塊（含內置UI）

1. 單擊Android Studio的導航欄，選擇File > New > Import Module...，選擇需要導入的模塊player_demo。

   說明

   其中AliyunPlayerBase、AliyunVideoCommon和thirdparty-lib模塊必須導入，其余模塊根據需要選擇性導入。詳細請參見demo目錄結構。

   

2. 單擊Finish，AndroidStudio會自動選中其他需要導入的模塊。

   

3. 導入成功后，需要手動引入thirdparty-lib，將該文件夾拷貝到項目中，并修改Project的build.gradle文件，引用thirdparty-lib文件和Maven倉庫。

   

   buildscript {
       apply from: 'thirdparty-lib/config.gradle'
   
       repositories {
           google()
           jcenter()
           maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
       }
   }
   
   allprojects {
       repositories {
           google()
           jcenter()
           maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
       }
   }

4. 進入app目錄下的build.gradle文件，修改參數compileSdkVersion、buildToolsVersion、minSdkVersion、targetSdkVersion的值，使其與播放器SDK Demo中Module目錄下thirdparty-lib/config.gradle文件中的值保持一致。

   

   如果出現下圖中的報錯，請參考故障排除排除故障。

5. 在app目錄下的build.gradle文件中，刪除AndroidX相關的依賴，并增加如下依賴。

   implementation externalAndroidSupportV4
   implementation externalAndroidAppCompatV7
   implementation project(':Aliyunplayer:player_demo')

   集成完后，可通過如下代碼跳轉到播放器的AliyunPlayer模塊。

   Intent intent = new Intent(MainActivity.this,AliyunPlayerSettingActivity.class);
   startActivity(intent);

集成Demo（不含內置UI）

播放器Demo中包含許多內置UI，如果您不需要內置UI（自定義UI或不使用UI），又想省去自己開發的麻煩，直接使用Demo中封裝好的功能，則可以通過以下步驟實現。

1. 集成播放器SDK。

   請參見快速集成。

2. 拷貝Demo中部分代碼。

   拷貝Aliyunplayer/AlivcPlayerTools/src/main/java/com/aliyun/player/alivecpalyerexpand/widget目錄下的文件：AliyunRenderView、IRenderView、TextureRenderView、SurfaceRenderView。

   說明

   • AliyunRenderView為播放器的封裝，將播放器和渲染的View綁定。

   • IRenderView用于統一渲染接口，SurfaceRenderView和TextureRenderView 都實現了IRenderView。

   • SurfaceRenerView和TextureRenderView分別對應使用SurfaceView和TextureView來渲染視頻畫面。

   • AliyunVodPlayerView無需拷貝，該文件提供的是AliyunRenderView的使用示例代碼。

   

3. 使用AliyunRenderView。

   可參考AliyunVodPlayerView文件中的示例代碼。

   1. 創建AliyunRenderView。

      <?xml version="1.0" encoding="utf-8"?>
      <!-- LinearLayout是根布局，可以修改為其他ViewGroup，這里僅是示例代碼 -->
      <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
            xmlns:app="http://schemas.android.com/apk/res-auto"
            xmlns:tools="http://schemas.android.com/tools"
            android:layout_width="match_parent"
            android:layout_height="match_parent">
      
            <!-- 播放器自定義View，封裝了播放器和渲染View，屬性說明：
              android:id為ViewId，請根據實際填寫
              android:layout_width為View的寬度，可修改，會影響播放畫面
              android:layout_height為View的高度，可修改，會影響播放畫面 -->
            <com.aliyun.playertest.playerDemo.AliyunRenderView
                android:id="@+id/aliyunRenderView"
                android:layout_width="match_parent"
                android:layout_height="200dp" />
      
        </LinearLayout>

   2. 調用接口。

      java
        //設置渲染View的類型，可選 SurfaceType.TEXTURE_VIEW 和 SurfaceType.SURFACE_VIEW
        aliyunRenderView.setSurfaceType(AliyunRenderView.SurfaceType.SURFACE_VIEW);
      
        //設置監聽
        aliyunRenderView.setXXXListener;
      
        //設置播放源，setDataSource為重載方法，還可以設置 sts，playAuth 等數據源
        aliyunRenderView.setDataSource(urlSource);
      
        //播放相關
        aliyunRenderView.prepare();
        aliyunRenderView.start()
        aliyunRenderView.pause()
        aliyunRenderView.stop()
        aliyunRenderView.release()

      說明

      上述代碼展示了部分接口，其余部分的接口可以參照AliyunVodPlayerView文件的示例代碼來使用，也可以根據播放器SDK的API接口文檔來使用AliyunRenderView。

故障排除

1. 打開app/AndroidManifest.xml文件，在application標簽中添加如下代碼。

   android:allowBackup="true"

   

2. 打開values/themes.xml及values-night/themes.xml文件，修改android:theme的themes資源文件為@style/Theme.AppCompat.NoActionBar。