ApsaraVideo VOD:Praktik terbaik untuk agent

Hasil eksekusi

Mengirimkan upload batch:

$ python vod_batch_upload.py

[1/2] Menginisialisasi klien VOD... ✓ (wilayah: cn-shanghai)
[2/2] Mengirimkan pekerjaan upload batch (3 video)... ✓
  RequestId: 25818875-5F78-4AF6-D7393642CA58****
  JobId: ad90a501b1b9****  ← sample1.mp4
  JobId: bd81b612c2c8****  ← sample2.mp4
  JobId: ce72c723d3d9****  ← sample3.mp4

Langkah-langkah berikutnya dipicu secara otomatis oleh notifikasi event:
  UploadByURLComplete → Auto Transcode → TranscodeComplete → GetPlayInfo

Layanan callback menerima event:

$ python callback_server.py
Layanan callback dimulai: http://0.0.0.0:8080 | Menunggu callback...

[UploadByURLComplete] VideoId=93ab850b**** | Status=success
  → Upload selesai, menunggu transkoding otomatis...

[StreamTranscodeComplete] VideoId=93ab850b**** | Status=success
  → Transkoding definisi LD selesai (siap untuk diputar)

[TranscodeComplete] VideoId=93ab850b**** | Status=success
  → Semua transkoding selesai, mendapatkan URL pemutaran:
    [LD] https://vod.example.com/****/sample1-ld.mp4?auth_key=****
    [SD] https://vod.example.com/****/sample1-sd.mp4?auth_key=****
    [HD] https://vod.example.com/****/sample1-hd.mp4?auth_key=****

Pengambilan dokumen oleh agent

Prompt: "Batch upload + transkode + pemutaran"
  │
  ▼
┌── llms.txt (Pencocokan quick start + Kendala kesalahan umum) ──┐
│  ✓ "Batch URL upload"         → media-upload/url-based-upload.md  │
│  ✓ "Event notification"       → event-notification/event-notification_2.md  │
│  ✓ "Playback URL"             → api-reference/get-playback-url.md   │
│  ✓ "Python init"              → api-reference/initialization_2.md   │
│  ✓ "Auto transcode"           → media-processing/workflow.md        │
│  ✗ #1 Jangan gunakan root AK ✗ #3 Jangan polling ✗ #5 Encode URL ✗ #6 Backoff QPS │
└────────────────────────┬─────────────────────────────────────┘
                         │
   ┌─────────────────────┼─────────────────────┐
   ▼                     ▼                     ▼
url-based-upload.md  event-notification_2.md get-playback-url.md
- UploadMediaByURL  - Daftar jenis event       - Parameter request/response
- URL harus diencode - Format callback HTTP    - Enumerasi Definition
- Batasan wilayah    - Kebijakan timeout & retry - QPS=360/detik
- Maks 20 URL        - Timeout 5 detik        - Status=Normal
   │                     │                     │
   ▼                     ▼                     ▼
   └────► initialization_2.md (konstruktor klien SDK) ◄────┘
                         │
                         ▼
                  workflow.md (Transkode otomatis dengan TemplateGroupId)
                         │
                         ▼
                Hasilkan kode lengkap yang dapat dijalankan

Keputusan desain utama

Tabel berikut mencantumkan keputusan desain utama untuk demo ini, dengan ID kendala eksplisit yang dirujuk kembali ke referensi kendala terstruktur.

Proses eksekusi agent

Fase 1: Baca indeks llms sisi klien dan cocokkan skenario

Hasil pencocokan quick start:
  "Mulai pemutaran VOD di Android"   → client-side-player/player-atomic-android.md
  "Cara memilih paket/dependensi" → client-side-player/player-overview.md
  "Cara mengintegrasikan lisensi"      → client-side-player/player-common-license.md
  "Penampil streaming langsung interaktif" → client-side-player/player-kits-aui.md
  "Kode error 4400/4013"           → client-side-player/player-common-error-codes.md

Kesalahan umum yang dicocokkan:
  ✗ Menginisialisasi lisensi setelah membuat pemutar → Harus dilakukan di Application.onCreate (C-1)
  ✗ Memanggil setSurface sebelum Surface siap      → Harus menunggu surfaceCreated (C-2)
  ✗ Menggunakan paket fitur lengkap secara default        → Pilih paket minimal untuk skenario (C-3)
  ✗ Hardcoding domain AppServer                   → Abstraksi ke BuildConfig / gradle.properties (C-4)
  ✗ Memanggil PrivateService.init beberapa kali        → Inisialisasi hanya sekali di kelas Application (C-5)

Fase 2: Muat dokumentasi detail sesuai permintaan

Fase 3: Ekstrak keputusan utama

Pemilihan paket:
  Hanya pemutaran          → AliVCSDK_BasicLive
  Pemutaran + video pendek   → AliVCSDK_UGC
  Termasuk co-hosting/streaming langsung interaktif  → AliVCSDK_InteractiveLive   ← Demo ini memilih yang ini
  Fitur lengkap          → AliVCSDK_Standard / Premium

Lisensi:
  PrivateService.initService(ctx, licenseFile, licenseKey)
  Harus diselesaikan sebelum panggilan pertama ke createAliPlayer

AUI Kits:
  AppServer + sisi klien; AppServer mengeluarkan Identity Token, Live Room Token, dan IMS Token.
  Klien: Tiga modul - AUILiveRoomCore, AUILiveRoomViewer, dan AUIInteraction.

Siapkan dependensi proyek

Dalam file build.gradle tingkat proyek:

allprojects {
    repositories {
        google()
        mavenCentral()
        maven { url "https://maven.aliyun.com/nexus/content/repositories/releases" }
    }
}

Dalam file build.gradle tingkat aplikasi:

android {
    compileSdk 34
    defaultConfig {
        applicationId "com.example.aliplayer.sample"
        minSdk 21
        targetSdk 34

        ndk { abiFilters "armeabi-v7a", "arm64-v8a" }

        buildConfigField "String", "APP_SERVER_HOST",
                "\"${project.findProperty('APP_SERVER_HOST') ?: 'https://your-appserver.example.com'}\""
        buildConfigField "String", "APP_SERVER_API_PREFIX", "\"/api/v1/live/\""
        buildConfigField "String", "LICENSE_KEY",
                "\"${project.findProperty('LICENSE_KEY') ?: ''}\""
    }
    buildFeatures { buildConfig true }
}

dependencies {
    implementation 'com.aliyun.aio:AliVCSDK_InteractiveLive:6.0.0'
    implementation 'androidx.appcompat:appcompat:1.6.1'
    implementation 'com.google.android.material:material:1.11.0'
    implementation 'com.squareup.okhttp3:okhttp:4.12.0'
    implementation 'com.google.code.gson:gson:2.10.1'
}

Konfigurasikan izin dan obfuscation

Dalam file AndroidManifest.xml:

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<uses-permission android:name="android.permission.WAKE_LOCK" />
<uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />

Dalam file proguard-rules.pro:

-keep class com.alivc.**{*;}
-keep class com.aliyun.**{*;}
-keep class com.cicada.**{*;}
-dontwarn com.alivc.**
-dontwarn com.aliyun.**
-dontwarn com.cicada.**

Inisialisasi lisensi

Buat file SampleApp.java:

public class SampleApp extends Application {
    @Override
    public void onCreate() {
        super.onCreate();
        // Tempatkan license.crt di app/src/main/assets/
        PrivateService.initService(getApplicationContext(),
                "file:///android_asset/license.crt",
                BuildConfig.LICENSE_KEY);
    }
}

Daftarkan SampleApp dalam file AndroidManifest.xml:

<application
    android:name=".SampleApp"
    android:label="@string/app_name"
    android:theme="@style/Theme.MaterialComponents.DayNight">
    <activity android:name=".MainActivity" android:exported="true">
        <intent-filter>
            <action android:name="android.intent.action.MAIN" />
            <category android:name="android.intent.category.LAUNCHER" />
        </intent-filter>
    </activity>
    <activity android:name=".SimplePlayerActivity" />
</application>

Bangun UI pemutaran video tunggal

Buat file layout activity_player.xml:

<FrameLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:background="#000">

    <SurfaceView
        android:id="@+id/surfaceView"
        android:layout_width="match_parent"
        android:layout_height="220dp"
        android:layout_gravity="center" />
</FrameLayout>

Buat file SimplePlayerActivity.java:

public class SimplePlayerActivity extends AppCompatActivity {

    public static final String EXTRA_PLAY_URL = "play_url";

    private AliPlayer aliPlayer;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_player);

        SurfaceView surfaceView = findViewById(R.id.surfaceView);
        aliPlayer = AliPlayerFactory.createAliPlayer(getApplicationContext());

        surfaceView.getHolder().addCallback(new SurfaceHolder.Callback() {
            @Override public void surfaceCreated(SurfaceHolder h) {
                aliPlayer.setSurface(h.getSurface());
            }
            @Override public void surfaceChanged(SurfaceHolder h, int f, int w, int hh) {
                aliPlayer.surfaceChanged();
            }
            @Override public void surfaceDestroyed(SurfaceHolder h) {
                aliPlayer.setSurface(null);
            }
        });

        aliPlayer.setOnPreparedListener(() -> aliPlayer.start());
        aliPlayer.setOnErrorListener(err ->
                Log.e("AliPlayer", "code=" + err.getCode() + " msg=" + err.getMsg()));

        UrlSource source = new UrlSource();
        // Sumber: URL pemutaran (dengan auth_key) dari respons GetPlayInfo demo sisi server
        String playUrl = getIntent().getStringExtra(EXTRA_PLAY_URL);
        source.setUri(playUrl != null ? playUrl : "https://your.cdn/test.mp4");
        aliPlayer.setDataSource(source);
        aliPlayer.setAutoPlay(true);
        aliPlayer.prepare();
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        if (aliPlayer != null) {
            aliPlayer.stop();
            aliPlayer.release();
        }
    }
}

Jika event prepared dan event frame pertama muncul di log serta SurfaceView merender gambar dengan benar, tautan dasarnya jelas.

Integrasikan penampil langsung AUI Kits

Impor modul AUI Kits

Dalam file settings.gradle:

include ':app',
        ':AUILiveRoomCore',
        ':AUILiveRoomViewer',
        ':AUIInteraction'

Dalam file build.gradle tingkat aplikasi, tambahkan dependensi berikut:

implementation project(':AUILiveRoomCore')
implementation project(':AUILiveRoomViewer')
implementation project(':AUIInteraction')

Model kolaborasi AppServer

Klien tidak pernah menyimpan kredensial sensitif secara langsung. Sebagai gantinya, AppServer mengeluarkannya setelah autentikasi. Diagram berikut menunjukkan alur kerja lengkap untuk memasuki ruang langsung:

[Aplikasi Android]                                [AppServer]
   │                                              │
   │── GET /api/v1/live/viewer/token?roomId=xxx ─►│
   │                                              ├── Autentikasi dan mengeluarkan:
   │                                              │     userId / nick / pullUrl / imsToken
   │◄──────── 200 OK + ViewerTokenInfo ───────────┤
   │
   │── LiveRoomViewerActivity.start(params) ──►(Di dalam AUI Kits)
   │                                              │
   │   (AliPlayer untuk penarikan aliran + IMS untuk komentar langsung)

1. Aplikasi Android mengirim permintaan GET /api/v1/live/viewer/token?roomId=xxx ke AppServer dengan status login.

2. AppServer memverifikasi status login dan mengeluarkan userId, nick, pullUrl, dan imsToken.

3. Setelah aplikasi menerima ViewerTokenInfo, aplikasi memanggil LiveRoomViewerActivity.start(params) untuk memasuki ruang langsung.

4. Secara internal, AUI Kits menggunakan AliPlayer untuk penarikan aliran dan terhubung ke Interactive Messaging Service (IMS) untuk fitur komentar langsung (danmaku), suka, dan hadiah.

AppServerClient (implementasi OkHttp)

Buat file AppServerClient.java dan ViewerTokenInfo.java:

public class AppServerClient {

    public interface Callback {
        void onSuccess(ViewerTokenInfo info);
        void onFail(String msg);
    }

    private static final OkHttpClient client = new OkHttpClient();

    public static void fetchViewerToken(String roomId, Callback cb) {
        HttpUrl url = HttpUrl.parse(
                BuildConfig.APP_SERVER_HOST + BuildConfig.APP_SERVER_API_PREFIX + "viewer/token")
                .newBuilder()
                .addQueryParameter("roomId", roomId)
                .build();

        Request req = new Request.Builder()
                .url(url)
                .header("Authorization", "Bearer " + LoginManager.getToken())
                .build();

        client.newCall(req).enqueue(new okhttp3.Callback() {
            @Override public void onFailure(Call call, IOException e) {
                cb.onFail(e.getMessage());
            }
            @Override public void onResponse(Call call, Response resp) throws IOException {
                if (!resp.isSuccessful() || resp.body() == null) {
                    cb.onFail("HTTP " + resp.code());
                    return;
                }
                ViewerTokenInfo info = new Gson().fromJson(
                        resp.body().string(), ViewerTokenInfo.class);
                cb.onSuccess(info);
            }
        });
    }
}

public class ViewerTokenInfo {
    public String roomId;
    public String userId;
    public String nick;
    public String pullUrl;   // Salah satu dari rtmp, flv, m3u8, atau artc
    public String imsToken;  // Token Interactive Messaging Service (IMS)
}

Gabungkan entri demo

Buat file layout activity_main.xml:

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:orientation="vertical"
    android:padding="24dp"
    android:gravity="center"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <Button android:id="@+id/btnSimple"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="Simple Playback" />

    <Button android:id="@+id/btnLiveRoom"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_marginTop="16dp"
        android:text="Interactive Live Viewer" />
</LinearLayout>

Buat file MainActivity.java:

public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        findViewById(R.id.btnSimple).setOnClickListener(v -> {
            Intent intent = new Intent(this, SimplePlayerActivity.class);
            // Dalam aplikasi nyata, berikan URL pemutaran dari respons GetPlayInfo demo sisi server di sini
            intent.putExtra(SimplePlayerActivity.EXTRA_PLAY_URL,
                    "https://vod.example.com/****/sample1-hd.mp4?auth_key=****");
            startActivity(intent);
        });

        findViewById(R.id.btnLiveRoom).setOnClickListener(v -> enterRoom("demo_room_001"));
    }

    private void enterRoom(String roomId) {
        AppServerClient.fetchViewerToken(roomId, new AppServerClient.Callback() {
            @Override public void onSuccess(ViewerTokenInfo info) {
                LiveRoomEnterParams params = new LiveRoomEnterParams.Builder()
                        .roomId(info.roomId)
                        .userId(info.userId)
                        .userNick(info.nick)
                        .pullUrl(info.pullUrl)
                        .imsToken(info.imsToken)
                        .build();
                LiveRoomViewerActivity.start(MainActivity.this, params);
            }
            @Override public void onFail(String msg) {
                Toast.makeText(MainActivity.this, "Gagal memasuki ruang: " + msg, Toast.LENGTH_LONG).show();
            }
        });
    }
}

Daftar periksa verifikasi

Setelah menjalankan demo, verifikasi perilaku UI dan output log berikut:

• Klik Simple Playback: SimplePlayerActivity dimulai, dan video diputar dengan lancar di SurfaceView tanpa layar hitam.

• Klik Interactive Live Streaming Viewer: LiveRoomViewerActivity AUI Kits diluncurkan. AliPlayer menampilkan feed video host. Panel komentar langsung (danmaku), suka, dan hadiah di pojok kanan bawah berfungsi.

• Log logcat utama: Kemunculan simultan AliPlayer: prepared, AliPlayer: first frame, dan IMS: connected menunjukkan bahwa penarikan aliran dan interaksi sudah siap.

Pengambilan dokumen agen

Prompt: "Pemutaran Android + masuk ruang langsung interaktif"
  │
  ▼
┌── Client-side llms.txt (Quick start + Kesalahan umum) ────────┐
│  ✓ "Pemutaran Android"        → player-atomic-android.md         │
│  ✓ "Cara memilih paket"   → player-overview.md               │
│  ✓ "Lisensi"                 → player-common-license.md          │
│  ✓ "Interaktif AUI Kits"    → player-kits-aui.md               │
│  ✓ "Kode error 4400/4013"   → player-common-error-codes.md     │
│  ✗ Lisensi harus diinisialisasi sebelum pembuatan pemutar           │
│  ✗ Jangan panggil setSurface sebelum Surface siap               │
│  ✗ Jangan gunakan paket fitur lengkap secara default              │
│  ✗ Jangan hardcoding domain AppServer                         │
│  ✗ Panggil PrivateService.init hanya sekali di Application          │
└────────────────────────┬────────────────────────────────────┘
                         │
  ┌─────────────┬────────┴─────────┬─────────────┐
  ▼             ▼                  ▼             ▼
player-      player-atomic-   player-common-  player-kits-aui.md
overview.md  android.md       license.md      - Kolaborasi AppServer
- Matriks paket - dependensi gradle    - PrivateService - Tiga jenis token
- Peta skenario - izin Manifest - 4400/4013     - Rincian modul
- Ukuran SDK     - kode Pemutaran  - Paket/BundleID - Integrasi klien 4 langkah
  └─────────────┴────────┬─────────┴─────────────┘
                         │
                         ▼
              player-common-error-codes.md
              (Panduan untuk 4400/4013/4034/4036)
                         │
                         ▼
              Hasilkan Demo Android lengkap yang dapat dijalankan

Keputusan desain utama

Daftar periksa pra-peluncuran

Struktur direktori akhir

AliPlayerSampleApp/
├── app/
│   ├── src/main/
│   │   ├── assets/license.crt
│   │   ├── java/com/example/aliplayer/sample/
│   │   │   ├── SampleApp.java
│   │   │   ├── MainActivity.java
│   │   │   ├── SimplePlayerActivity.java         ← Simple Playback
│   │   │   ├── AppServerClient.java              ← Streaming Langsung Interaktif
│   │   │   ├── ViewerTokenInfo.java
│   │   │   └── LoginManager.java
│   │   └── AndroidManifest.xml
│   └── build.gradle
├── AUILiveRoomCore/                               ← Streaming Langsung Interaktif
├── AUILiveRoomViewer/                             ← Streaming Langsung Interaktif
├── AUIInteraction/                                ← Streaming Langsung Interaktif
├── gradle.properties (APP_SERVER_HOST / LICENSE_KEY)
├── settings.gradle
└── build.gradle

Demo sisi server dan sisi klien membentuk alur kerja tertutup yang lengkap. Dengan menggunakan indeks llms.txt, Agent mencakup pengunggahan video, transkoding otomatis, pengambilan URL pemutaran, pemutaran video dasar, dan penampil streaming langsung interaktif dengan AUI Kits.

Kapan menggunakan Coding Agent

Opsi yang direkomendasikan

Pemeriksaan mandiri minimum

Kirimkan prompt berikut ke Coding Agent Anda untuk memverifikasi kemampuannya:

Silakan baca https://ice-document-materials.oss-cn-shanghai.aliyuncs.com/vod/llms/llms.txt,
dan beri tahu saya:
1. Berapa banyak modul tingkat atas dalam indeks ini? Apa saja?
2. Dokumen sub mana yang terlibat dalam alur kerja "upload batch + transkoding otomatis + dapatkan URL pemutaran audio/video"? Harap cantumkan path relatifnya.
3. Di bagian "Kesalahan umum yang harus dihindari", apa catatan yang terkait dengan "AccessKey"?

Jawaban yang diharapkan:

• Benar mencantumkan modul tingkat atas dari llms.txt.

• Mencantumkan dokumen sub yang sebagian besar konsisten dengan tabel pemuatan sesuai permintaan dalam demo sisi server (upload media, notifikasi event, dapatkan URL pemutaran audio/video, inisialisasi SDK Python, alur kerja pemrosesan media).

• Menyatakan dengan jelas: Jangan gunakan AccessKey Akun Alibaba Cloud. Gunakan Pengguna RAM sebagai gantinya.

Agent yang lulus ketiga pemeriksaan tersebut siap untuk demo di atas.