All Products
Search

This Product

    ApsaraVideo VOD:DescribeVodPlayerMetricData

    Document Center

    ApsaraVideo VOD:DescribeVodPlayerMetricData

    Last Updated:Jul 21, 2026

    Mengkueri data deret waktu pemutar.

    Coba sekarang

    Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

    Test

    RAM authorization

    Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

    • Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.

    • API: API yang dapat Anda panggil untuk melakukan aksi tersebut.

    • Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.

    • Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.

      • Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.

      • Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.

    • Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.

    • Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

    Action

    Access level

    Resource type

    Condition key

    Dependent action

    vod:DescribeVodPlayerMetricData

    none

    *全部资源

    *

    		 None None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    AppId

    string

    Yes

    ID aplikasi.

    app-1000000
    StartTime

    string

    Yes

    Waktu mulai kueri. Format: yyyy-mm-ddthh:mm:ssz (UTC).

    Catatan

    • Mendukung kueri riwayat data pemutaran untuk satu tahun terakhir.

    • Rentang waktu untuk satu kueri tidak boleh melebihi 31 hari.

    • Interval waktu bersifat tertutup kiri dan terbuka kanan [StartTime, EndTime).

    2025-06-24T00:55:06Z
    EndTime

    string

    Yes

    Waktu akhir kueri. Format: yyyy-mm-ddthh:mm:ssz (UTC).

    2025-06-05T15:59:59Z
    Interval

    string

    Yes

    Granularitas waktu untuk mengkueri data. Nilai valid: 5m, 1h, dan 1d. Granularitas waktu yang didukung bergantung pada rentang waktu antara StartTime dan EndTime:

    • Dalam 3 hari: 5m, 1h, dan 1d.

    • 4 hingga 7 hari: 1h dan 1d.

    • Lebih dari 7 hari: 1d.

    1d
    TerminalType

    string

    Yes

    Tipe terminal. Nilai valid:

    • web: web.

    • mobile: native.

    web.
    Filters

    string

    No

    Filter dimensi data deret waktu. Dimensi terdiri dari tipe dimensi (Field), operator (Op), dan nilai dimensi.

    Catatan

    • Maksimal tiga dimensi dapat ditentukan.

    • Ketika parameter Metrics mencakup empat data deret waktu berikut, Filters tidak berlaku: Uv (pengguna pemutaran), AvgPerVv (rata-rata pemutaran per pengguna), AvgPerPlayDuration (rata-rata durasi pemutaran per pengguna), dan AvgPerCompletionVv (rata-rata pemutaran selesai per pengguna).

    • Untuk provinsi dan negara, kirimkan regionCode.

    • Pisahkan beberapa nilai dengan #_#.

    Nilai valid untuk tipe dimensi (Field):

    • SdkVersion: versi SDK.

    • AppVersion: versi aplikasi.

    • Codec: Kodek.

    • VideoType: format video.

    • Network: jenis jaringan.

    • Country: negara.

    • Isp: ISP.

    • VideoDefinition: resolusi.

    • Domain: nama domain.

    • Province: provinsi.

    • IsHw: apakah dekode perangkat keras digunakan.

    • ErrorCode: kode kesalahan.

    Nilai valid untuk operator (Op): = (sama dengan), > (lebih besar dari), < (lebih kecil dari), dan != (tidak sama dengan).

    Catatan

    • SdkVersion dan VideoDefinition mendukung keempat operator. Data deret waktu lain hanya mendukung = (sama dengan) dan != (tidak sama dengan).

    Ambil nilai dimensi dengan memanggil DescribeVodPlayerDimensionData.

    [ { "Field": "Kodek", "Op": "=", "Value": "h265#_#h264" }, { "Field": "os", "Op": "=", "Value": "Android#_#iOS" } ]
    Metrics

    string

    Yes

    Tipe data deret waktu. Anda dapat memilih beberapa data deret waktu (maksimal 3).

    Catatan

    • Data persentase dikembalikan dalam bentuk desimal.

    Data deret waktu Quality of Service (QoS):

    • Vv: jumlah pemutaran.

    • RealVv: jumlah pemutaran aktual.

    • FirstFrame: waktu frame pertama.

    • SecondPlayRate: laju pemutaran instan.

    • SlowPlayRate: laju pemutaran lambat.

    • StuckCountRate: laju tersendat berdasarkan jumlah.

    • SeekDuration: durasi seek.

    • StuckDuration100s: durasi tersendat per 100 detik.

    • StuckCount100s: jumlah tersendat per 100 detik.

    • PlayFailRate: laju kegagalan pemutaran.

    • SeedFailRate: laju non-pemutaran.

    • AvgPlayBitrate: bitrate pemutaran rata-rata.

    • AvgStartBitrate: bitrate mulai rata-rata.

    • ErrorCount100s: jumlah error per 100 detik.

    Data deret waktu Quality of Experience (QoE):

    • Uv: pengguna pemutaran.

    • AvgPerVv: rata-rata pemutaran per pengguna.

    • AvgVideoDuration: durasi video rata-rata.

    • AvgPerPlayDuration: rata-rata durasi pemutaran per pengguna.

    • AvgPerCompletionVv: rata-rata pemutaran selesai per pengguna.

    • CompletionVv: jumlah selesai.

    • CompletionRate: laju penyelesaian.

    • AvgPlayDuration: durasi pemutaran rata-rata.

    • JumpRate5s: tingkat pantulan 5 detik.

    Vv,Uv,AvgPerVv.
    Top

    integer

    No

    Mengembalikan data untuk N item teratas yang diurutkan berdasarkan jumlah pemutaran. Jika parameter ini tidak ditentukan, data untuk semua dimensi akan dikembalikan.

    5
    PageNumber

    integer

    No

    Nomor halaman. Nilai default: 1.

    1
    PageSize

    integer

    No

    Jumlah entri per halaman. Nilai default: 5000. Nilai maksimum: 5000.

    5000
    Language

    string

    No

    Bahasa tanggapan. Nilai valid:

    • zh (default): Bahasa Mandarin Sederhana.

    • en: Bahasa Inggris.

    zh
    Os

    string

    No

    Sistem operasi pemutar. Tentukan parameter ini untuk melakukan kueri terfilter untuk data pemutaran sistem operasi tertentu. Nilai valid: Android, iOS, Harmony, Windows, MacOS, dan Linux. Nilai yang tersedia bervariasi berdasarkan tipe terminal:

    • native: Android, iOS, Harmony.

    • web: Android, iOS, Harmony, Windows, MacOs, Linux.

    Pisahkan beberapa nilai dengan #_#.

    Android、iOS、Windows.

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Skema Respons.

    RequestId

    string

    ID permintaan.

    25818875-5F78-4A*****F6-D7393642CA58
    PageNumber

    integer

    Nomor halaman saat ini.

    1
    PageSize

    integer

    Ukuran halaman.

    5000
    TotalCnt

    integer

    Jumlah total titik data.

    500
    DataList

    array<object>

    Daftar data yang dikembalikan.

    object

    TimeStamp

    string

    Stempel waktu data. Format: yyyy-mm-ddthh:mm:ssz (UTC).

    2025-06-24T00:55:06Z

    Dimension

    string

    Dimensi.

    H265_MP4_WIFI.
    Uv

    number

    Jumlah pengguna pemutaran.

    500
    Vv

    number

    Jumlah pemutaran.

    800
    RealVv

    number

    Jumlah pemutaran aktual.

    1000
    FirstFrame

    number

    Waktu frame pertama, dalam milidetik (ms).

    100
    SecondPlayRate

    number

    Laju pemutaran instan.

    0.8
    SlowPlayRate

    number

    Laju pemutaran lambat.

    0.2
    StuckCountRate

    number

    Laju tersendat berdasarkan jumlah.

    0.1
    SeekDuration

    number

    Durasi seek, dalam milidetik (ms).

    100
    StuckDuration100s

    number

    Durasi tersendat per 100 detik, dalam milidetik (ms).

    200
    PlayFailRate

    number

    Laju kegagalan pemutaran.

    0.2
    SeedFailRate

    number

    Laju non-pemutaran.

    0.01
    AvgPlayBitrate

    number

    Laju bitrate pemutaran rata-rata, dalam bps.

    100
    AvgStartBitrate

    number

    Laju bitrate mulai rata-rata, dalam bps.

    100
    ErrorCount100s

    number

    Jumlah error per 100 detik.

    1
    AvgPerVv

    number

    Rata-rata pemutaran per pengguna.

    10
    AvgVideoDuration

    number

    Durasi video rata-rata, dalam milidetik (ms).

    100000
    AvgPerPlayDuration

    number

    Rata-rata durasi pemutaran per pengguna, dalam milidetik (ms).

    100000
    AvgPerCompletionVv

    number

    Rata-rata pemutaran selesai per pengguna.

    2
    CompletionVv

    number

    Jumlah selesai.

    500
    CompletionRate

    number

    Laju penyelesaian.

    0.8
    AvgPlayDuration

    number

    Durasi pemutaran rata-rata, dalam milidetik (ms).

    100000

    JumpRate5s

    number

    Tingkat pantulan 5 detik.

    0.1
    TotalPlayDuration

    number

    Total durasi pemutaran, dalam milidetik (ms).

    100000
    StuckCount100s

    string

    Jumlah tersendat per 100 detik.

    2
    Extend

    object

    Informasi tambahan.

    ActualStartTime

    string

    Waktu paling awal dengan titik data dalam rentang waktu yang ditentukan. Format: yyyy-mm-ddthh:mm:ssz (UTC).

    2025-06-24T00:55:06Z
    ActualEndTime

    string

    Waktu paling akhir dengan titik data dalam rentang waktu yang ditentukan. Format: yyyy-mm-ddthh:mm:ssz (UTC).

    2025-06-05T15:59:59Z
    IntervalSeconds

    integer

    Granularitas waktu data yang dikueri, dalam detik (s).

    3600

    Contoh

    Respons sukses

    JSONformat

    {
  "RequestId": "25818875-5F78-4A*****F6-D7393642CA58",
  "PageNumber": 1,
  "PageSize": 5000,
  "TotalCnt": 500,
  "DataList": [
    {
      "TimeStamp": "2025-06-24T00:55:06Z\n",
      "Dimension": "H265_MP4_WIFI",
      "Uv": 500,
      "Vv": 800,
      "RealVv": 1000,
      "FirstFrame": 100,
      "SecondPlayRate": 0.8,
      "SlowPlayRate": 0.2,
      "StuckCountRate": 0.1,
      "SeekDuration": 100,
      "StuckDuration100s": 200,
      "PlayFailRate": 0.2,
      "SeedFailRate": 0.01,
      "AvgPlayBitrate": 100,
      "AvgStartBitrate": 100,
      "ErrorCount100s": 1,
      "AvgPerVv": 10,
      "AvgVideoDuration": 100000,
      "AvgPerPlayDuration": 100000,
      "AvgPerCompletionVv": 2,
      "CompletionVv": 500,
      "CompletionRate": 0.8,
      "AvgPlayDuration": 100000,
      "JumpRate5s": 0.1,
      "TotalPlayDuration": 100000,
      "StuckCount100s": "2"
    }
  ],
  "Extend": {
    "ActualStartTime": "2025-06-24T00:55:06Z",
    "ActualEndTime": "2025-06-05T15:59:59Z",
    "IntervalSeconds": 3600
  }
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 Meter.ParamError Param Error:%s,Please Check Again.
    500 Meter.ServerInternalError The Request Processing Has Failed Due To Some Unknown Error.
    500 Meter.DataSourceQueryError Data Source Error:%s,Please Try Again.
    403 Meter.AuthError Authentication Failed,Please Try Again.
    502 Meter.ReadyTsError Get ReadyTs Failed,Please Try Again.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.