Player creation and management

Prev Next

Available in Classic and VPC

Player creation and management introduces how to create, configure, edit, deploy, and delete players from the NAVER Cloud Platform console's Video Player Management menu. It also explains how to check the SDK download URL and download the SDK.

Create player

To create a player:

Note

For the Basic pricing plan, you can only create 1 player. To create 2 or more players, switch to the Standard pricing plan.

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. Click the [Create] button.
  5. When the player creation page appears, enter the basic information.
    • Player name: Enter a name for the player.
      • Must be 3-30 characters long and begin with a letter. It must consist of a combination of letters, numbers, and special characters (_, -, @).
    • Site domain: Enter the site URL where the player will be displayed to check domain validity.
    • App package ID: Enter the app package ID to use the mobile SDK.
    • SDK version: Select the SDK version to use.
  6. Click the [Create] button.
  7. Click the [OK] button in the player creation popup window.
    • The player is created and displayed on the list.

Set up player

To set player options:

Note
  • This section explains how to set player options in the NAVER Cloud Platform console. To set the player options in more detail by manually editing the script code, see the player settings script provided in this guide.
  • For the Basic pricing plan, you can set the playback source only in the console. To set various options in the console, switch to the Standard pricing plan.
  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. Click the [Option settings] button of the player you want to configure from the player list.
  5. Depending on the options to configure, check the following considerations:

Playback source

Set the playback sources. To set the options in more detail by manually editing the script code, see Playback source.

  • URL: Enter the content playback URL.
  • Poster: Enter the URL of the thumbnail.
  • CC: Enter the URL of the subtitle file.
    • You can provide subtitles in two languages.

Playback settings

Set the playback options. To set the options in more detail by manually editing the script code, see Playback settings.

  • Autoplay: Select whether to use autoplay.
  • Mute: Select whether to play on mute.
  • Repeated playback: Select to play on repeat.
  • Speed: Select the speed rate to make available on the UI. You cannot change the speed rate if none is selected.
  • Ultra-low latency mode: Select whether to use Low Latency HLS.
  • Initial release date: Set the initial release date.

Player UI

Set the options for the player UI. To set the options in more detail by manually editing the script code, see Player UI.

  • Set the options for player aspect ratio.
    • Aspect ratio: Select the aspect ratio for the player.
    • Full screen: Select the full screen options for playback sources.
  • Set the options for control bar.
    • Control bar: Select whether to use the player control bar.
    • Control UI type: Select the UI for the player's control bar.
    • Control bar color: Choose a color for the seek slider.
    • Auto-hide controls: Select the time to hide the control bar automatically.
    • Language settings: Select the language displayed in the control bar.
    • Play button: Set whether to display the Play button.
    • Adjust the volume: Set whether to display the volume control UI.
    • Time display: Set whether to display total video time and current playing time.
    • PIP: Set whether to display the Picture-in-Picture (PIP) player mode toggle button.
    • Full screen: Select whether to display the full screen toggle button.
    • Subtitles: Set whether to display the subtitle settings button.
    • Settings: Set whether to display the player settings button.
  • To set the options for custom buttons, click the toggle button of Settings first and set it to True. When the setting options are displayed, complete the following settings, and then click the [Add] button.
    • Button image URL: Enter the custom button image URL.
    • Button position: Select where to add the custom buttons.
    • Creation location: Select the position to add the custom buttons, relative to the existing buttons.
    • Button UI: Select the device environment to apply the custom buttons.
    Note

    For the exact location of the custom buttons, see Adding a custom button.

Player UX

Set the options for the player UX. To set the options in more detail by manually editing the script code, see Player UX.

  • Display mute indication: Select whether to display mute status.
  • Text watermark: Select whether to display the text watermark.
    • If you select Enable, choose to use a random location for the text watermark, and then set the following options:
      • When using the random location, select the time interval for changing the location of the text watermark.
      • If random location is not enabled, set the horizontal/vertical position value and transparency of the text watermark.
  • Thumbnail preview: Select whether to add preview thumbnails on the seek slider.
  • Auto-pause when the browser is inactive: Select whether to automatically pause when the browser or WebView is inactive.
  • Touch gestures: Select whether to use the navigation feature via touch in mobile mode.
  • Keyboard shortcuts: Select whether to enable player control with the keyboard.
  • IOS web full screen mode: Select full-screen mode for iOS mobile Safari.

Metadata

Set the metadata. To set the options in more detail by manually editing the script code, see Metadata.

  • Description: Set whether to display video title, uploader information, etc. at the top of the player.
  • Title: Enter the video title.
  • Upload date: Enter the video upload date.
  • Profile: Enter the profile information.
  • Profile image: Enter the profile image URL.
Note

Directly implement the click event via script code to enable actions when metadata is clicked. For more information, see Metadata click events.

DRM test

You can test the application of DRM to playback content.

Note
  • You can also run DRM testing through script code. For more information, see console DRM testing.
  • When running a DRM test in the console, the settings are not reflected in the script within the console.

To test:

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, click the [Set options] button for the player to test.
  5. Click the [DRM test] tab.
  6. After selecting the test environment, enter the content information for testing.
    • Select the test environment based on the browser type.
      • Widevine/PlayReady: Select when testing in Chrome or Edge browsers on Windows OS.
      • FairPlay: Select when testing on the Safari browser on Mac OS.
    • When selecting Widevine/PlayReady, enter the DASH playback source URL and DRM token value, in order.
    • When selecting FairPlay, enter the HLS playback source URL, Certificate URL, and DRM token value, in order.
  7. Click the [Test play] button.

Replicate player

You can replicate a player to easily create a new player with the same options.
To clone a player:

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, select the player to replicate, and then click the [Replicate] button.
  5. In the replicate video player popup window, set the information for the player to be created, and then click the [Create] button.
    • Player name: Enter a player name to be displayed on the console.
      • Must be 3-30 characters long and begin with a letter. It must consist of a combination of letters, numbers, and special characters (_, -, @).
    • SDK auto-update: Select whether to enable the SDK auto-update feature.
    • SDK version: Select the SDK version to use.
    • A player with the same options as the selected one is created and displayed in the list.

Deploy player

Once the settings are complete, the player can be deployed to either the development or production environment, depending on the purpose of the deployment. You can also roll back the settings for players deployed to the development environment.

Deploy for development

To deploy to the development environment for testing before deploying to the real environment:

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, click the [Option settings] button for the player to be deployed to the development environment.
  5. After previewing the player to be deployed, click the [Deploy for development] button.
    • The player is deployed to the development environment.

Deploy for production

To deploy to the real environment for real users:

Note
  • Only players that have been deployed to the development environment can be deployed for production. For more information, see Deploy for development.
  • Production deployment deploys the player that was last deployed to the development environment to the production environment. Therefore, to apply the changes to the real environment, make sure to first conduct Deploy for development after editing the options. If you deploy for production before development, the changed options are not applied to the real environment.
  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, click the [Option settings] button for the player to be deployed to the production environment.
  5. After previewing the player to be deployed, click the [Deploy for production] button.
  6. Click the [OK] button in the Deploy for production popup window.
    • It is deployed to the production environment with the same options as those deployed to the development environment.

Roll back development settings

To roll back the settings for Deploy for development:

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, click the [option settings] button for the player to roll back.
  5. Click the [Roll back development settings] button.
  6. Check the details in the Roll back development settings popup window and then click the [OK] button.
    • The development settings for the player are rolled back and changed to match the settings for the real environment.

Delete player

To delete a player:

Note

If you delete a player connected to the Media Analytics service, the player is also automatically deleted from the player integration list.

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, select the player to delete, and then click the [Delete] button.
  5. Check the details in the delete popup window and then click the [Delete] button.
    • The player is deleted and removed from the player list.

View and download SDK addresses

To check the SDK address or download the SDK for Native player development:

Note

For the Basic pricing plan, you can't download the SDKs. To download SDKs, switch to the Standard pricing plan.

  1. In the NAVER Cloud Platform console, select your environment from the Region and Platform menus.
  2. Navigate to Services > Media > Video Player Enhancement.
  3. Click the Video Player Management menu.
  4. In the player list, click the [SDK address] button for the player to check the SDK address or download the SDK.
  5. To check the SDK address, select the service environment of the SDK address to check.
    • You can check the SDK address of the selected service environment in the SDK address, and copy the SDK address to the clipboard by clicking the [Copy] button.
  6. To download the SDK, click the [IOS] or the [Android] button, depending on your device.
    • It is downloaded as a zipped file.