Understanding the Music Validation Tool
Amazon requires that devices including Alexa Music feature to be certified for music functionality before launching that device to the public. Certifying Alexa Music on a device ensures that the device adequately supports music partners such as Amazon Music, iHeartRadio, and SiriusXM. To facilitate validating your device against the Music Certification checklist, Amazon offers a Music Validation Tool (MVT) for developers. The Music Certification Validation tool performs three different types of validation:
To expedite Amazon's certification of your device, ensure that your device passes all of the certification checklists provided by Alexa Music before submitting your device to Amazon. Download and review each checklist for each Music Service Provider (MSP) that you plan to support:
The checklists verify that a device executes back-end events correctly to calculate royalty payments.
The Coverage Validation performed by the Music Validation Tool ensures that your device has been self-tested against a concise set of utterances and scenarios that meet the requirements specified by Alexa's supported Music Service Providers (MSPs). If your test run does not cover all of the required scenarios provided in the checklists, Amazon cannot accept that test run for certification. You will need to re-run the test to ensure that all test cases are accurately tested for your certification pass.
A test run that fails Coverage Validation indicates that the test did not execute correctly. Some common root causes of Coverage Validation failures include the following issues:
- Missing/incomplete/incorrect/wrong sequence of utterances.
- Wait time is less than the minimum requirement.
- Utterance was not actually issued but was still executed by the device.
See Music Validation Certification Requirements and Troubleshooting to learn more about the causes and resolutions for common test failures.
AVS AudioPlayer API Validation
AVS AudioPlayer API Validation validates that all of the API events implemented by the device firmware are executed in the correct order. This validation has the following components:
- Validate the event sequence and their response to directives of the AudioPlayer State machine.
- Validate that the playback reporting events are sent within acceptable time windows and that the reported offsets are correct.
- Validate implementation of the ProgressReportIntervalElapsed and ProgressReportDelayElapsed events.
For assistance troubleshooting API Validation failures, see the Music Validation Certification Requirements and Troubleshooting.