China Delivery with Brightcove Player

Introduction

Brightcove provides a solution for delivering video to China from outside the country. The solution is comprised of two parts:

• A proxy server hosted within China
• A connected China-specific CDN

The proxy routes non-video traffic (Playback API requests, Analytics beacons, and the web player itself) to and from viewers in China to Brightcove infrastructure located outside.

The CDN is connected to the proxy and handles the video and image content.

Requirements

The following requirements are needed to support Brightcove China Delivery:

Setup

• There are setup requirements in addition to configuring your player

  For details, see Overview: China Delivery

Brightcove Player

• Brightcove Player version 6.44 or later required; latest version recommended

Configuring Brightcove Player

To deliver video within China, you must configure the player to use the Brightcove China Delivery proxy.

To create a China-compatible player, follow these steps:

1. In Video Cloud Studio, open the PLAYERS module. Use an existing player or create a new one.

2. Select the player's name link to open the player's properties.

3. In the left navigation, select JSON Editor.

   

4. To set the proxy, add the following:

   "china_proxy_domain": "china.example.com"

5. Your code should look similar to this:

   

6. Click Save, and publish the player.
7. When you embed or share your player, notice that the embed code uses the Brightcove Player CDN.

   <script
     src="//players.brightcove.net/1752604059001/jnOD8yLME_default/index.min.js">
   </script>

8. Change the Brightcove Player CDN to use your China Delivery domain.

   <script
     src="//china.example.com/1752604059001/jnOD8yLME_default/index.min.js">
   </script>

Note

With china_proxy_domain set, all requests initiated by the player will be sent to URLs within that domain. Using the sample value above (china.example.com) users may see requests to:

Localization

With china_proxy_domain set, Brightcove Player will automatically be configured with two languages:

• zh-Hans: Simplified Chinese (default)
• zh-Hant: Traditional Chinese

Setting a china_proxy_domain has the same effect as setting the following configurations (though these are not needed):

"language": "zh-Hans",
"languages": ["zh-Hans", "zh-Hant"],

This default effect of the china_proxy_domain will not occur if any value is provided for the language or languages configuration! To override default behavior, you can mix and match these configurations.

Adding more languages

If more languages than zh-Hans and zh-Hant are needed, you can add a languages configuration to the player. This configuration might look something like:

"china_proxy_domain": "china.example.com",
"languages": ["zh-Hans", "zh-Hant", "en", "jp"],

The player in this example would still default to zh-Hans, but would also add the English and Japanese languages.

Changing the default language

To configure a different default language than zh-Hans, add a language configuration. The configuration should look similar to this:

"china_proxy_domain": "china.example.com",
"language": "zh-Hant",

Limitations

For details about the limitations for this feature, see the Overview: China Delivery document.