Panduan ini menjelaskan cara memulai penggunaan AliPlayerKit untuk Flutter.
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
Buat controller dan konfigurasikan data
Dalam metode
initState, buat instanceAliPlayerWidgetController.Gunakan
VideoSourceFactoryuntuk membuatvideoSource.Bungkus data pemutaran—seperti sumber video dan judulnya—dalam instance
AliPlayerWidgetData.
Bind data dan render UI
Panggil
_controller.configure(data)untuk mengikat data.Dalam metode
build, gunakanAliPlayerWidget(_controller)untuk menyematkan widget UI pemutar.
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.