All Products
Search
Document Center

ApsaraVideo VOD:Mulai Cepat

Last Updated:Sep 10, 2026

Panduan ini menjelaskan cara memulai penggunaan AliPlayerKit untuk Flutter.

Catatan

Sebelum memulai, pastikan lingkungan Anda telah dikonfigurasi dan dependensi telah ditambahkan sebagaimana dijelaskan dalam Prasyarat.

Contoh mulai cepat

Contoh berikut menunjukkan cara menyematkan pemutar video di halaman dan mengimplementasikan pemutaran video hanya dengan beberapa baris kode.

import 'package:flutter/material.dart';
import 'package:aliplayer_widget/aliplayer_widget_lib.dart';

void main() {
  // === 0. Inisialisasi pengaturan global untuk widget pemutar ===
  // Opsional: Widget ini mencakup pengaturan yang direkomendasikan, sehingga konfigurasi tambahan biasanya tidak diperlukan. Untuk pengaturan khusus, lihat dokumen "Custom Configurations".
  // Gunakan AliPlayerWidgetGlobalSetting untuk menerapkan pengaturan global.
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return const MaterialApp(home: VideoPlayerPage());
  }
}

class VideoPlayerPage extends StatefulWidget {
  const VideoPlayerPage({super.key});

  @override
  _VideoPlayerPageState createState() => _VideoPlayerPageState();
}

class _VideoPlayerPageState extends State<VideoPlayerPage> {
  late AliPlayerWidgetController _controller;

  @override
  void initState() {
    super.initState();

    // === 1. Buat controller dan konfigurasikan data ===

    // Buat sumber video.
    final videoSource = VideoSourceFactory.createVidAuthSource(
      vid: "<your-video-id>",
      playAuth: "<your-play-auth>",
    );

    // Konfigurasikan data untuk widget pemutar.
    final data = AliPlayerWidgetData(
      videoSource: videoSource,
      videoTitle: "<your-video-title>",
    );

    // Inisialisasi controller untuk widget pemutar.
    _controller = AliPlayerWidgetController();
    _controller.configure(data);
  }

  @override
  void dispose() {
    // === 3. Anda harus melepas sumber daya saat halaman dihapus ===
    _controller.destroy();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('AliPlayerWidget Demo')),
      // === 2. Sematkan widget UI pemutar ===
      body: AliPlayerWidget(_controller),
    );
  }
}

Langkah-langkah utama

  1. Buat controller dan konfigurasikan data

    • Dalam metode initState, buat instance AliPlayerWidgetController.

    • Gunakan VideoSourceFactory untuk membuat videoSource.

    • Bungkus data pemutaran—seperti sumber video dan judulnya—dalam instance AliPlayerWidgetData.

  2. Bind data dan render UI

    • Panggil _controller.configure(data) untuk mengikat data.

    • Dalam metode build, gunakan AliPlayerWidget(_controller) untuk menyematkan widget UI pemutar.

  3. Lepaskan sumber daya:

    • Dalam metode dispose, panggil _controller.destroy() untuk menghindari kebocoran memori.

Kasus penggunaan lainnya

Contoh ini menunjukkan penggunaan dasar untuk VOD. Untuk kasus penggunaan lanjutan, seperti live streaming dan putar balik daftar, lihat proyek contoh aliplayer_widget_example untuk kode dan instruksi lengkap.