ApsaraVideo VOD:Get started with the Flutter player SDK

Étape 1 : Créer un lecteur

FlutterAliplayer fAliplayer = FlutterAliPlayerFactory.createAliPlayer();
fAliplayer.setTraceID("traceId");

Le paramètre setTraceID gère la journalisation d'instrumentation, qui alimente la surveillance de la qualité de lecture, le suivi ponctuel et les statistiques de lecture vidéo.

Pour utiliser le suivi ponctuel, transmettez un identifiant unique pour l'utilisateur ou l'appareil, tel que votre ID utilisateur métier, un International Mobile Equipment Identity (IMEI) ou un IDFA (identifier for advertisers).

Étape 2 : Configurer la vue vidéo

Créez un widget AliPlayerView et associez le lecteur une fois la vue créée.

// 1. Create the player view widget
AliPlayerView aliPlayerView = AliPlayerView(
  onCreated: onViewPlayerCreated,
  x: 0,
  y: 0,
  width: width,
  height: height,
  aliPlayerViewType: AliPlayerViewTypeForAndroid.surfaceview);

// 2. Attach the player to the view
void onViewPlayerCreated(viewId) async {
  fAliplayer.setPlayerView(viewId);
}

Étape 3 : Définir la source de lecture

Le SDK prend en charge trois types de sources de lecture. Choisissez-en un en fonction de votre cas d'utilisation.

fAliplayer.setVidAuth(
  vid: "<your-video-id>",       // Required. The video ID (VideoId).
  playAuth: "<your-play-auth>", // Required. The playback credential from GetVideoPlayAuth.
  region: "<your-region>",      // Required. The region of ApsaraVideo VOD. Default: cn-shanghai.
);

fAliplayer.setVidSts(
  vid: "<your-video-id>",              // Required. The video ID (VideoId).
  accessKeyId: "<your-access-key-id>",         // Required. The AccessKey ID from the temporary AccessKey pair.
  accessKeySecret: "<your-access-key-secret>", // Required. The AccessKey secret from the temporary AccessKey pair.
  securityToken: "<your-security-token>",      // Required. The STS token.
  region: "<your-region>",             // Required. The region of ApsaraVideo VOD. Default: cn-shanghai.
);

fAliplayer.setUrl("<your-video-url>");

Étape 4 : Démarrer la lecture

fAliplayer.prepare();
fAliplayer.play();

Étape 5 : Libérer le lecteur

Lorsque la lecture est terminée, arrêtez le lecteur, libérez les ressources et effacez la référence pour éviter les fuites de mémoire.

fAliplayer.stop();
fAliplayer.release();
fAliplayer = null; // Prevents memory leaks

Appelez toujours release() et définissez le lecteur sur null lorsqu'il n'est plus nécessaire. Sinon, des fuites de mémoire se produisent.

// Step 1: Create a player
FlutterAliplayer fAliplayer = FlutterAliPlayerFactory.createAliPlayer();
fAliplayer.setTraceID("traceId");

// Step 2: Set up the video view
AliPlayerView aliPlayerView = AliPlayerView(
  onCreated: (viewId) async {
    fAliplayer.setPlayerView(viewId);
  },
  x: 0,
  y: 0,
  width: width,
  height: height,
  aliPlayerViewType: AliPlayerViewTypeForAndroid.surfaceview);

// Step 3: Set the playback source (VidAuth)
fAliplayer.setVidAuth(
  vid: "<your-video-id>",
  playAuth: "<your-play-auth>",
  region: "<your-region>",
);

// Step 4: Start playback
fAliplayer.prepare();
fAliplayer.play();

// Step 5: Release the player when done
fAliplayer.stop();
fAliplayer.release();
fAliplayer = null;