ApsaraVideo VOD:FAQ about ApsaraVideo Player

License-related issues

Resolve invalid or expired license issues in License FAQ.

Player SDK for Web license configuration and authorized domain names

Player SDK for Web validates a License against the domain name of the web page that hosts the player. Use this entry to configure the authorized domain name, handle License errors during initialization, and complete the License configuration when you upgrade the SDK.

• Authorized domain name: The authorized domain name is the business access domain name of the web page that hosts the player, not the ApsaraVideo VOD resource domain. Bind the domain name by exact match or by wildcard matching. Configure test domain names and production domain names in the same way: complete domain ownership verification for each domain name in the console, and then apply for a free License.

• license resource init error during initialization: This error usually occurs when debug mode is enabled, for example, when vconsole is enabled. It does not affect normal playback. Disable debug mode, or check the browser developer tools (Console and Network) for any other errors that are reported.

• Authorization page stuck on a loading placeholder: If the SDK list or the License authorization page cannot read data and keeps showing a loading placeholder, create a Player SDK for Web application and bind the authorized domain name directly.

• Upgrade to the latest Player SDK for Web version: Replace the CSS and JavaScript reference URLs. The rest of your code stays compatible, so you do not need to integrate the API operations again. You must add the license parameter, which contains domain and key, to the initialization configuration. Apply for a free License in the console and bind the authorized domain name before you initialize the player.

Common issues across platforms

• For platform-independent issues, check Cross-platform player FAQs.

• Experienced developers can also troubleshoot playback errors independently.