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 address and download the SDK.

Create player

To create a player, follow these steps:

Note

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

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  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 the name to manage the player
      • Must be 3-30 characters long and begin with a letter. They must contain lowercase letters, numbers, and special letters (hyphens, underscores, and/or @).
    • Site domain: enter the site URL that displays the player to check domain validity
    • App package ID: enter the app package ID to use the mobile SDK version
    • SDK version: select 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, follow these steps:

Note
  • This section explains how to set player options in NAVER Cloud Platform console. If you want 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, upgrade to the Standard pricing plan.
  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click the [Option Settings] button on the player to configure options in the player's list.
  5. Depending on the options to configure, check the following considerations:

Playback source

Set the playback sources. If you want to set the options in more detail by manually editing the script code, see Playback source.

  • URL: enter URL for contents to play
  • Poster: enter URL for thumbnail
  • CC: enter URL for the subtitle file
    • You can see subtitles in two languages.

Playback settings

Set the playback options. If you want to set the options in more detail by manually editing the script code, see Playback settings.

  • Automatic playback: select to autoplay
  • Mute: select to play with mute during playback
  • Repeated playback: select to play on repeat
  • Speed: select the speed rate to be provided through UI. You can't change the speed rate if it's not selected
  • Ultra-low latency mode: select whether to use the Low Latency HLS
  • Initial release date: set the initial release date

Player UI

Set the options for the player UI. If you want 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 aspect ratio for the player
    • Full screen: select full screen options for playback sources
  • Set the options for control bar.

    • Control bar: select to use the player control bar
    • Control UI type: select UI to provide 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 to display the play button
    • Adjust the volume: set to display the volume control UI
    • Time display: set to display total video time and current playing time
    • PIP: set to display the PIP (Picture In Picture) player mode toggle button
    • Full screen: set to display the full screen toggle button
    • Subtitles: set to display the subtitle settings button
    • Settings: set to display the player settings button
  • To set the options for custom buttons, click the toggle button in 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 image URL for the custom buttons
    • Button position: select the area where the custom buttons are added
    • Creation location: select the position for the additional custom buttons based on the current 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. If you want to set the options in more detail by manually editing the script code, see Player UX.

  • Display mute indication: select to display the mute status
  • Text watermark: select 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 value 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.
  • Segment navigation preview: select to add preview thumbnails on the navigation slider of the control bar
  • Auto-stop when the browser is not activated: select to automatically stop when the browser or webview is not activated
  • Touch gestures: select to use the segment navigation function with touch in the mobile mode
  • Keyboard shortcuts: select to use the player control function with the keyboard

Metadata

Set the metadata. If you want to set the options in more detail by manually editing the script code, see Metadata.

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

When clicking metadata, the click event that can implement an action is directly implemented with the script code. For more information, see Metadata Click Events.

DRM test

You can test the DRM application on playback content.

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

To test, follow these steps:

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click the [option settings] button for the player to test in the player list.
  5. Click the [DRM test] tab.
  6. After selecting the test environment, enter the content information to test.
    • Select the test environment based on the browser type.
      • Widevine.PlayReady: select when testing in Chrome or Edge browsers on Windows OS
      • FairPlay: select options when testing on the Safari browser in 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. Enter 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, follow these steps:

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click to select the player from the player list for duplication, and then click the [Replicate] button.
  5. In the Replicate Video Player popup window, set the player information to be duplicated, and then click the [Create] button.
    • Player name: enter the player name to be displayed on the console
      • Must be 3-30 characters long and begin with a letter. They must contain lowercase letters, numbers, and special letters (hyphens, underscores, and/or @).
    • SDK auto-update: select to use the SDK auto-update feature
    • SDK version: select 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 (Develop) or real (Production) environment, depending on the purpose of the deployment. You can also roll back the settings for players to be deployed to the development environment.

Deploy for development

To deploy to the development environment for testing before deploying to the real environment, follow these steps:

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click the [Option settings] button for the player to be deployed to the development environment in the player’s list.
  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, follow these steps:

Note
  • Only players that have been deployed to the development environment can be deployed for production. For more information, see Deploy for development.
  • In this step, you deploy the player that has been most recently deployed for development to the real 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. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click the [Option settings] button for the player to be deployed to the real environment in the player’s list.
  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.
    • The same options deployed to the development environment are deployed to the real environment.

Roll back development settings

To roll back the settings for Deploy for development, follow these steps:

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click the [option settings] button for the player to roll back in the player’s list.
  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, follow these steps:

Note

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

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Click to select the player to delete from the player list, and then click the [Delete] button.
  5. Check the details in the delete popup window and then click the [Delete] button.
    • Since the player is deleted, it disappears from the player list.

View and download SDK addresses

To develop a Native player, follow these steps to check the SDK address and download the SDK:

Note

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

  1. Click the environment you are using in the Region menu and Platform menu of the NAVER Cloud Platform console.
  2. Click Services > Media > Video Player Enhancement in order.
  3. Click the Video Player Management menu.
  4. Check the SDK address in the player’s list or click the [SDK Address] button for the player to 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.