Media Debugging Tips

From MozillaWiki
Jump to navigation Jump to search

Diagnosing and Reporting Media Playback Issues in Firefox

Basic Media Playback Issues

For simple playback issues (videos on popular sites that fail to play back properly), the first place to start is to check the web developer console for error messages related to format issues. If you see messages here related to media playback errors, please file a Bugzilla report. When filing please file a Audio/Video related Bugzilla report and include a URL to the video.

Playback Performance Issues

For playback performance issues and general media playback problems, capturing and reporting a Firefox Performance Profile can help Mozilla developers diagnose the issue. Please visit the Firefox Profiler Getting Started Guide to learn how to record a profile. Note, before recording, please select the 'Media' setting in the profiler toolbar dropdown menu. Once you have a profile recorded of the media playback issue, you can post the resulting profile url to your Bugzilla report for analysis.

Profiler Quick Start:
1) Visit https://profiler.firefox.com/ and enable the Profiler toolbar button
2) Click the toolbar button down arrow and select 'Media' in the Settings drop down.
3) Open a tab and visit the page with the affected media content.
4) Click the Profiler toolbar main button to start recording.
5) Play the media until the issue you are seeing manifests.
6) Click the Profiler toolbar button again to stop recording.
7) When a new Profile tab opens, click the upload profile button on the upper right.
8) Copy the resulting profile URL and post this to your Bugzilla report.

Advanced Diagnosis

In some cases developers will ask reporters to capture detailed media processing logs. This can help diagnose low level content format problems or incompatibilities. If you have already reported a bug in Bugzilla, you can capturing detailed logging as well to help diagnose.

Steps: 1) Open a tab and visit about:logging 2) In the 'Logging preset:' drop down select 'Media Playback' 3) Click the 'Set Log Modules' button 4) Collect Firefox Performance Profile as described above and report the profile URL to your Bugzilla report.