- Print
- PDF
Create and manage the player
- Print
- PDF
Available in Classic and VPC
Creating and managing players introduces how to create, configure, edit, deploy, and delete players from the Video Player Management menu on the NAVER Cloud Platform console. It also explains how to check the SDK address and download the SDK.
Create player
Create a player as follows:
For the Basic pricing plan, you can only create 1 player. To create 2 or more players, upgrade to the Standard pricing plan.
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [Create] button.
- When the player creation page appears, enter the basic information.
- Player name: enter the name to manage the player
- The name must start with English letters. Enter alphabet, numbers, and special characters (within 3 to 30 characters in combination with _, -@).
- 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
- Player name: enter the name to manage the player
- Click the [Create] button.
- Click the [OK] button in the player creation prompt.
- The player is created and displayed on the list.
Set up player
The followings describe how to set player options:
- 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.
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [Option Settings] button on the player to configure options in the player's list.
- 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
- Object fit: select object fit 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: select the color of the control bar’s video navigation 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
- Volume control: 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
NoteFor 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 notifications: 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.
- If you select Enable, choose to use a random location for the text watermark, and then set the following options:
- 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
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.
- 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.
The following describes how to test:
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [option settings] button for the player to test in the player list.
- Click the [DRM test] tab.
- 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 that order.
- Select the test environment based on the browser type.
- Enter the [Test Play] button.
Replicate player
You can replicate a player to easily create a new player with the same options.
The followings describe how to clone a player:
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click to select the player from the player list for duplication, and then click the [Replicate] button.
- In the Replicate Video Player prompt, 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
- The name must start with English letters. Enter alphabet, numbers, and special characters (within 3 to 30 characters in combination with _, -@).
- 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.
- Player name: enter the player name to be displayed on the console
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.
The player deployment feature is only available on the Standard pricing plan. To use this feature, upgrade to the Standard pricing plan.
Deploy to Develop
The followings describe how to deploy to the development environment for testing before deploying to the real environment:
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [Option settings] button for the player to be deployed to the development environment in the player’s list.
- After previewing the player to be deployed, click the [Deploy to Develop] button.
- The player is deployed to the development environment.
Deploy to Production
The followings describe how to deploy to the real environment for real users:
- Only players deployed to the development environment can be deployed to Production. For more information, see Deploy to Develop.
- Production deployments deploy the last player to be deployed to Develop to the real environment. Therefore, to apply the changes to the real environment, make sure to first conduct a Develop deployment after editing the options. If you deploy to Production before Develop, the changed options are not applied to the real environment.
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [Option settings] button for the player to be deployed to the real environment in the player’s list.
- After previewing the player to be deployed, click the [Deploy to Production] button.
- Click the [OK] button in the Deploy to Production prompt.
- The same options deployed to the development environment are deployed to the real environment.
Roll back Develop
The followings describe how to roll back the settings for deployed to Develop:
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click the [option settings] button for the player to roll back in the player’s list.
- Click the [Roll back Develop] button.
- Check the details in the Roll back Develop prompt and then click the [OK] button.
- The settings of the player deployed in Develop are rolled back and changed to match the settings in the real world.
Delete player
The followings describe how to delete a player:
If you delete a player connected to the Media Analytics service, the player is also automatically deleted from the player integration list.
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Click to select the player to delete from the player list, and then click the [Delete] button.
- Check the details in the delete prompt 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, the following shows how to check the SDK address and download the SDK:
For the Basic pricing plan, you can't download the SDKs. To download SDKs, upgrade to the Standard pricing plan.
- Click the environment you are using in the Region menu and the Platform menu on the NAVER Cloud Platform console.
- Click Services > Media > Video Player Enhancement.
- Click the Video Player Management menu.
- Check the SDK address in the player’s list or click the [SDK Address] button for the player to download the SDK.
- 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.
- To download the SDK, click the [IOS] or the [Android] button, depending on your device.
- It is downloaded as a zipped file.