All Products
Search
Document Center

ApsaraVideo VOD:FAQ Unggah Aset Media

Last Updated:Jun 22, 2026

Topik ini menjelaskan masalah umum terkait unggah aset media beserta solusinya.

File tersangkut dalam status mengunggah

Hal ini dapat disebabkan oleh salah satu alasan berikut:

  • Penyebab 1: Unggah berbasis URL merupakan proses asinkron dan tidak menjamin penyelesaian tepat waktu.

    Metode unggah berbasis URL bersifat asinkron dan tidak menjamin penyelesaian tepat waktu. Proses unggah dapat memakan waktu beberapa jam hingga beberapa hari. Metode ini hanya tersedia di wilayah China (Shanghai), China (Beijing), China (Shenzhen), Singapore, dan US (Silicon Valley). Kami menyarankan Anda mengintegrasikan unggah SDK sisi server ApsaraVideo VOD untuk proses unggah.

  • Penyebab 2: Anda hanya menghasilkan kredensial unggah tanpa benar-benar mengunggah file.

    Pemanggilan API CreateUploadVideo hanya memperoleh kredensial unggah dan membuat informasi dasar aset media. API ini tidak mengunggah file aktual. Anda tetap perlu memanggil operasi OSS untuk menyelesaikan unggah file. Untuk prosedur lengkapnya, lihat Unggah file media dengan memanggil API ApsaraVideo VOD.

  • Penyebab 3: Unggah lambat karena ukuran file besar.

    Periksa apakah durasi unggah sesuai dengan ukuran file. Secara default, metode seperti menggunakan Konsol, unggah SDK, dan alat klien menggunakan unggah multi-bagian, yang mendukung file tunggal hingga 48,8 TB. Unggah SDK juga menyediakan fitur unggah simple, yang mendukung file tunggal hingga 5 GB.

  • Penyebab 4: Masalah jaringan.

    Verifikasi bahwa lebar pita jaringan Anda memenuhi persyaratan.

Unggah iOS SDK gagal dengan error NSCocoaErrorDomain

Error ini, dengan kode kesalahan 207 dan pesan 'Error Domain=NSCocoaErrorDomain', biasanya menunjukkan error pembacaan file akibat izin yang tidak mencukupi. Anda dapat mengatasi masalah ini dengan salah satu cara berikut:

  • Metode 1: Berikan izin kepada unggah SDK untuk iOS agar dapat membaca sumber daya lokal.

  • Metode 2: Tempatkan sumber daya lokal ke direktori sandbox sebelum memulai unggah.

Unggah berbasis URL: error "not open in current region"

Pesan kesalahan The service is not open in current region menunjukkan bahwa unggah berbasis URL tidak didukung di wilayah saat ini. Fitur ini hanya tersedia di wilayah tertentu, termasuk China (Shanghai) dan Singapore.

Jika Anda berada di wilayah yang tidak didukung, unduh file tersebut secara lokal lalu unggah menggunakan unggah SDK. Untuk informasi lebih lanjut, lihat Ikhtisar unggah SDK.

Tidak dapat melihat gambar yang diunggah di Konsol

Gambar yang diunggah dengan tipe diatur sebagai cover diperlakukan sebagai sampul video dan tidak ditampilkan di Konsol ApsaraVideo VOD. Gambar tersebut hanya dapat diambil dengan memanggil API. Untuk informasi lebih lanjut, lihat CreateUploadImage.

Masalah kompatibilitas unggah JavaScript SDK di WeChat

Masalah ini disebabkan oleh ketidakcocokan implementasi HTML5 di browser WeChat. Untuk mengatasinya, hapus parameter multiple="" dari tag <input type="file" name="file" id="files" multiple="">.

Pratinjau terdistorsi dengan stream ingest SDK

Ketika Anda memilih resolusi aliran 480p di stream ingest SDK, halaman pratinjau mungkin tampak terdistorsi, tetapi output aliran aktual tetap normal. Hal ini terjadi karena 480p sesuai dengan resolusi 480×640 piksel. Karena rasio aspek ini tidak didukung oleh sebagian besar layar ponsel, pratinjau tampak terdistorsi.

Solusi: Ubah rasio aspek SurfaceView pada halaman pratinjau. Perbarui file activity_push.xml Anda sebagai berikut.

public void initView() {
    mPreviewView = (SurfaceView) findViewById(R.id.preview_view);
    mPreviewView.getHolder().addCallback(mCallback);
}
<?xml version="1.0" encoding="utf-8"?>
<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent">
    <SurfaceView
            android:id="@+id/preview_view"
            android:layout_width="match_parent"
            android:layout_height="match_parent"/>

    <!--FrameLayout-->
        <!--android:id="@+id/publisher_fragment"-->
        <!--android:layout_width="match_parent"-->
        <!--android:layout_height="match_parent"-->
        <!--android:visibility="gone"/>-->

    <android.support.v4.view.ViewPager
            android:id="@+id/tv_pager"
            android:layout_width="match_parent"
            android:layout_height="match_parent"
            >
    </android.support.v4.view.ViewPager>
</RelativeLayout>

Menampilkan dan mengimpor paket AAR di Android Studio

Untuk melihat data dalam paket AAR, ubah ekstensi file dari .aar menjadi .zip, lalu dekompresi file tersebut. Anda kemudian dapat melihat isinya, seperti file .class, file .xml, file .jar, gambar, dan file teks.

Untuk mengimpor paket AAR:

  1. Salin file .aar ke direktori proyek Anda, biasanya projectName/libs/, lalu muat ulang proyek. Salin file library seperti AlivcPlayer.aar, aliyun-vod-upload-android-sdk-1.1.1.jar, aliyun-vod-croe-android-sdk-1.2.1.jar, gson-2.8.0.jar, dan jsr305-3.0.0.jar ke direktori app > libs proyek Anda. Setelah menyalin file, muat ulang proyek.

  2. Dalam file build.gradle Anda, tambahkan path repositori lokal di bawah tag root dan tambahkan dependensi kompilasi.

    Nilai dirs harus sesuai dengan direktori tempat Anda meletakkan paket tersebut. Untuk dependensi compile, atur name ke nama file AAR (tanpa ekstensi) dan ext ke 'aar'.

    repositories{
        flatDir{
            dirs 'libs'
        }
    }
    
    dependencies {
        compile fileTree(include: ['*.jar'], dir: 'libs')
        testCompile 'junit:junit:4.12'
        compile 'com.android.support:appcompat-v7:26+'
        compile 'com.android.support:design:26+'
        compile (name:'AlivcPlayer',ext:'aar')
        // The upload SDK depends on the OSS upload SDK.
        compile 'com.aliyun.dpa:oss-android-sdk:2.4.5'
    }
  3. Pilih Build > Rebuild untuk membangun ulang proyek.

    Setelah proses build selesai, paket AAR yang diimpor akan muncul di bagian External Libraries proyek Anda.

    External Libraries
    ├── Android API 26 Platform
    ├── JRE 1.8
    ├── AlivcPlayer:@aar
    │   ├── classes.jar (library root)
    │   │   └── com
    │   │       ├── alivc.player
    │   │       └── aliyun.aliyunplayer
    │   └── res (library root)
    │       ├── values
    │       └── values-zh-rCN
    ├── com.aliyun.dpa:oss-android-sdk-2.4.5
    ├── com.android.support:animated-vector-drawable:26.0.0-alpha1
    ├── com.android.support:appcompat-v7:26.0.0-alpha1
    ├── com.android.support:design:26.0.0-alpha1
    ├── com.android.support:recyclerview-v7:26.0.0-alpha1
    ├── com.android.support:support-annotations:26.0.0-alpha1
    └── com.android.support:support-compat:26.0.0-alpha1

Tautan terkait

Untuk prosedur unggah yang lebih detail, lihat topik-topik berikut:

  • Untuk informasi tentang cara mengunggah file menggunakan Konsol ApsaraVideo VOD atau alat unggah berbasis PC, lihat Unggah menggunakan alat GUI.

  • Untuk informasi tentang cara mengunggah file menggunakan metode seperti unggah SDK ApsaraVideo VOD, SDK OSS native, unggah berbasis URL, atau operasi API OSS, lihat Unggah menggunakan alat developer.