ApsaraVideo VOD:Test the demo of ApsaraVideo Player SDK for Android

Demo of ApsaraVideo cloud-device integration solution

Environment requirements

Prerequisites

The ApsaraVideo Player SDK package for Android is downloaded. The package contains ApsaraVideo Player SDK for Android and the demo. We recommend that you download the latest version. For more information about the download link, see SDK download.

Integrate the complete demo (with the built-in UIs)

After you import the complete demo of ApsaraVideo Player SDK for Android, you can use the features of ApsaraVideo Player without the need to separately integrate SDKs.

In the navigation bar of Android Studio, choose File > Open. Import the demo of ApsaraVideo Player, as shown in the following figure.

Integrate specific modules in the demo (with the built-in UIs)

1. In the navigation bar of Android Studio, choose File > New > Import Module.... Select the player_demo module.
   Note You must import the AliyunPlayerBase, AliyunVideoCommon, and thirdparty-lib modules. You can also import other modules as needed. For more information, see Table 2.

   
2. Click Finish. Android Studio automatically selects other required modules, as shown in the following figure.
   
3. After the modules are imported, copy the thirdparty-lib module to your project and add the reference to the module and the URL of the Alibaba Cloud Maven repository to the build.gradle file of the project.
   

   buildscript {
       apply from: 'thirdparty-lib/config.gradle'
   
       repositories {
           google()
           jcenter()
           maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
           // The URL of the Maven repository that is required for screen mirroring.
           maven { url 'http://4thline.org/m2' }
       }
   }
   
   allprojects {
       repositories {
           google()
           jcenter()
           maven { url "http://maven.aliyun.com/nexus/content/repositories/releases" }
           // The URL of the Maven repository that is required for screen mirroring.
           maven { url 'http://4thline.org/m2' }
       }
   }

4. Open the build.gradle file in the app directory and change the values of the compileSdkVersion, buildToolsVersion, minSdkVersion, and targetSdkVersion parameters to the values provided in the thirdparty-lib/config.gradle file in the Module directory of the demo.
   

   If the error in the following figure appears, see the Troubleshooting section in this topic troubleshoot the error.
5. In the build.gradle file of the app directory, remove the AndroidX-related dependencies and add the following dependencies:

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

   After integration, you can run the following code to use the AliyunPlayer module of ApsaraVideo Player:

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

Integrate the demo (without the built-in UIs)

The demo provides a variety of built-in UIs. However, you may have custom UIs or require no UI at all. In this case, you can perform the following steps to use only the features provided by the demo:

1. Integrate ApsaraVideo Player SDK for Android.
   For more information, see Integration.
2. Copy specific code in the demo.
   Copy the AliyunRenderView, IRenderView, TextureRenderView, and SurfaceRenderView files in the Aliyunplayer/AlivcPlayerTools/src/main/java/com/aliyun/player/alivecpalyerexpand/widget directory.

   Note

   • The AliyunRenderView file is used to encapsulate the player and bind the player with the render view.
   • The IRenderView file defines the basic rendering interface. Both SurfaceRenderView and TextureRenderView are implemented based on IRenderView.
   • The SurfaceRenderView file is used to render video images based on the SurfaceView class. The TextureRenderView file is used to render video images based on the TextureView class.
   • You do not need to copy the AliyunVodPlayerView file because this file contains the sample code of the AliyunRenderView class.

   
3. Use the AliyunRenderView class.
   For more information, see the sample code in the AliyunVodPlayerView file.
   1. Create an AliyunRenderView object.

      <?xml version="1.0" encoding="utf-8"?>
      <!-- LinearLayout is the root view group in this example. You can use other view groups as needed. -->
      <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">
      
            <! -- The custom view of the player, which encapsulates the player and the render view. Parameters:
              The android:id parameter specifies the view ID. Set this parameter to the actual value.
              The android:layout_width parameter specifies the width of the view. You can change the value, but the value change may affect the playback image.
              The android:layout_height parameter specifies the height of the view. You can change the value, but the value change may affect the playback image. -->
            <com.aliyun.playertest.playerDemo.AliyunRenderView
                android:id="@+id/aliyunRenderView"
                android:layout_width="match_parent"
                android:layout_height="200dp" />
      
        </LinearLayout>

   2. Call the methods of the AliyunRenderView class.

      java
        // The method that can be called to specify the type of the render view. You can set the type to SurfaceType.TEXTURE_VIEW or SurfaceType.SURFACE_VIEW.
        aliyunRenderView.setSurfaceType(AliyunRenderView.SurfaceType.SURFACE_VIEW);
      
        // The method that can be called to set listeners.
        aliyunRenderView.setXXXListener;
      
        // The method that can be called to configure the playback source. The setDataSource method is a reload method. You can call this method to configure playback sources such as sts and playAuth.
        aliyunRenderView.setDataSource(urlSource);
      
        // The playback-related methods.
        aliyunRenderView.prepare();
        aliyunRenderView.start()
        aliyunRenderView.pause()
        aliyunRenderView.stop()
        aliyunRenderView.release()

      Note The preceding code shows specific methods of the AliyunRenderView class. You can call other methods of the AliyunRenderView class based on the sample code of the AliyunVodPlayerView class. You can also call other methods of the AliyunRenderView class based on the API reference of ApsaraVideo Player SDK for Android.

Troubleshooting

If the error in the following figure appears when you use the built-in UIs and specific features provided by the demo of ApsaraVideo Player, perform the following steps for troubleshooting:

1. Open the app/AndroidManifest.xml file and add the following code to the application tag:

   android:allowBackup="true"

   
2. Open the values/themes.xml and values-night/themes.xml files and change the value of android:theme to @style/Theme.AppCompat.NoActionBar.