QA/OpenH264/Test Plan

Summary

Feature	Release	Dev Lead	QA Lead	Contributor	QA Status
openH264 plugin	Firefox 33	Georg Fritzsche	Alexandra Lucinet	Hossain Al Ikram	N/A

Intro

OpenH264, released by Cisco under the BSD license, is a codec library which supports H.264 encoding and decoding. It is suitable for use in real time applications such as WebRTC.

• Details
  • OS Support
    • Windows 64-bit and 32-bit
    • Mac OS X 64-bit and 32-bit
    • Linux 64-bit and 32-bit
    • Android 32-bit
    • iOS 64-bit and 32-bit
  • Processor Support
    • Intel x86 optionally with MMX/SSE
    • ARMv7 optionally with NEON
    • Any architecture using C/C++ fallback functions

References

• openH264 homepage
• Source code
• Wiki page
• Mozilla blog post
• Cisco blog post

Testing Approach

Many thanks go out to Ikram for his great help in testing of openh264 plugin

• OpenH264 plugin is available via Add-ons Manager -> Plugins in approximately 1 minute after launching Firefox 33.
  • Note: Before the plugin downloads and installs, the "Will be installed shortly" warning is displayed
• To verify that the plugin is properly installed, navigate to http://mozilla.github.io/webrtc-landing/pc_test_h264.html and start a h.264 video call
  • Note: Make sure that Require H.264 video checkbox is marked

Requirements

Details on how to generate logs:

• Open about:config and click on "I'll be careful, I promise!" button
• Set:
  • media.gmp-manager.log to true
  • browser.dom.window.dump.enabled to true
• Create:
  • media.gmp-gmpopenh264.provider.logging.level (right click -> New -> String) set to 0
  • media.gmp-gmpopenh264.provider.logging.dump (right click -> New -> Boolean) set to true

Notes:

• Launch Firefox through the Command prompt/Terminal to view all the logs as it follows:
  • For Windows Platform: use 'cd' command to get to the Firefox folder and enter 'firefox -no-remote -p -console' command
  • For Mac OS X Platform: /Applications/Firefox/Firefox.app/Contents/MacOS/firefox-bin -p -console
    • Note: make sure the path to Firefox is the correct one
  • For Linux Platform: use 'cd' command to get to the Firefox folder and './firefox -no-remote -p -console' command
• Example of good logs

Launch Firefox (through the Terminal) and wait for the plugin to install via Add-ons Manager

Default state

State after installation

Prefs generated after successful plugin installation

Example of a successful h264 call

• Test page:
  • http://mozilla.github.io/webrtc-landing/pc_test_h264.html

One and Done tasks

Task for this feature are also available on One and Done, right here

Moztrap Tests

• OpenH264 plugin Tests

Bug work

All bugs:

Full Query

ID	Summary	Status	Resolution
1009760	Hook up crash reporting for GMP plugins (openh264)	VERIFIED	FIXED
1009765	Add GMP plugin crashes to FHR crash reporting	VERIFIED	FIXED
1009816	Firefox desktop: openh264 updates: check, download, install	VERIFIED	FIXED
1009909	Firefox desktop: Integrate the openh264 media plugin in the add-ons manager	VERIFIED	FIXED
1013354	Implement openh264 update manifests in Balrog	RESOLVED	FIXED
1039028	Provide info when "Show More Information" is selected for the OpenH264 plugin in the addon manager	VERIFIED	FIXED
1039226	Trigger explicit OpenH264 updates from OpenH264Provider	VERIFIED	FIXED
1040048	Register the OpenH264 plugin from the OpenH264Provider on startup	VERIFIED	FIXED
1040937	Open H264 plugin stuck in disabled state after download	VERIFIED	FIXED
1040941	Non-functional "preference" button for Open H264 plugin (depending on state)	VERIFIED	FIXED
1041080	Fix OpenH264Provider path registration, default enabled state and logging	VERIFIED	FIXED
1042161	Handle OpenH264 updates for long-running sessions	VERIFIED	FIXED
1043531	OpenH264 crash reporting notification not shown	VERIFIED	FIXED
1044245	GMP with OpenH264 crashes on Windows.	VERIFIED	FIXED
1045209	The OpenH264 path should be relative to the profile directory and include a version subdirectory	VERIFIED	FIXED
1045500	Crash reporter notification cuts off OpenH264 plugin name	VERIFIED	FIXED
1046644	Honor OpenH264 autoupdate pref for the initial GMP install check	VERIFIED	FIXED
1047374	Missing "Submit a crash report" button from OpenH264 crash reporting notification [Windows only]	RESOLVED	WORKSFORME
1049501	crash in mozilla::gmp::PGMPParent::DeallocShmems()	VERIFIED	FIXED
1053473	Add GMP crash submissions to the crash manager with the proper type	RESOLVED	INVALID
1053748	[FHR] Crashing gmp using media.gmp.plugin.crash pref does not store data in FHR	RESOLVED	WONTFIX
1056029	[Linux] OpenH264 crash reporting notification not always shown	RESOLVED	WORKSFORME
1056035	Unnecessarily line displayed above Find Updates option for h264 plugin	VERIFIED	FIXED
1056041	'Change when this add-on runs' button changes size when clicked	RESOLVED	INACTIVE
1062259	OpenH264 plugin is not installing on Firefox 33b1, 34.0a2 and 35.0a1	RESOLVED	WORKSFORME
1076808	[OpenH264] v1.0 displayed in License information and crash reports instead of v1.1	RESOLVED	INVALID

26 Total; 0 Open (0%); 8 Resolved (30.77%); 18 Verified (69.23%);