If your application uses ApsaraVideo Player SDK to play videos, you can use the live streaming playback data service to monitor the playback quality of your application. This service relies on event tracking data reported by ApsaraVideo Player SDK to provide metrics such as playback success rate, instant startup rate, and stuttering rate. These metrics help you quickly assess the quality of live streaming playback. This topic describes how to view playback data.
How it works
The live streaming playback data service relies on event tracking data reported by ApsaraVideo Player SDK. The following diagram shows the event tracking logic.
Usage notes
Ensure that you are using ApsaraVideo MediaBox SDK, your license is valid, and data reporting is enabled.
Native player SDK version 5.4.9.2 or later is supported.
Web player SDK version 2.16.0 or later is supported.
To download the player SDK, see SDK introduction. To manage SDK licenses, see Manage a license.
View playback data
- Log on to the ApsaraVideo Live console.
In the navigation pane on the left, choose .
On the Playback Statistics tab, select an application name and click Query.
NoteThe application name must match the title that you specified when you applied for an ApsaraVideo Player SDK license. If the names do not match, no data is displayed.
You can filter data by the following dimensions:
Filter by client type, operating system, resolution, or network type.
You can query data for custom time ranges from the last hour to the last three days. The duration of each query cannot exceed 24 hours or span multiple days.
Filter by SDK version, encoding format, video format, hardware decoding (Yes or No), ISP, domain name, or province. Click New Filter Condition to add a condition. You can save frequently used conditions for future use.
The Application Overview section shows Quality of Service (QoS) metrics. These metrics reflect the playback quality of your application. The following table describes each metric:
NoteThe Average Frame Rate metric applies only to video scenarios. All other metrics apply to audio and video or audio-only scenarios.
Metric
Description
Average First Frame Duration (Millisecond)
The time between initiating a playback request and rendering the first frame.
Stuttering Rate (%)
The percentage of total stuttering duration relative to total playback duration. Calculation: Stuttering duration / Playback duration.
Average Frame Rate (fps)
The frame rate at which video frames are rendered during live streaming playback.
Outgoing Bitrate (Kbps)
The outbound network transmission rate during live streaming playback.
Instant Startup Rate (%)
The percentage of live streams that start playback within 1 second. Calculation: Number of live streams started in ≤1 second / Total number of live streams played.
Slow Startup Rate (%)
The percentage of live streams that start playback after 3 seconds. Calculation: Number of live streams started in ≥3 seconds / Total number of live streams played.
Playback Success Rate (%)
The percentage of successful playback attempts. Calculation: Successful playback attempts / Total playback attempts.
CPU Usage (%)
The CPU usage during live streaming playback.
Single-point tracing
If an error occurs during video playback that uses ApsaraVideo Player SDK, you can use single-point tracing to track abnormal behavior for a specific user or playback session across the full stack. This helps you quickly diagnose root causes and improve the playback experience.
- Log on to the ApsaraVideo Live console.
In the navigation pane on the left, choose
Click the Single-point Tracing tab. Enter the TraceID or UUID that was provided when the player was created.
Click View Details in the Actions column to view the details of the playback session.