Skip to content

android.md

Latest commit

 

History

History
76 lines (42 loc) · 2.76 KB

android.md

File metadata and controls

76 lines (42 loc) · 2.76 KB

Basic Setup

NexPlayer synchronization can be enabled by setting the following property:

mNexPlayer.setProperty(NexPlayer.NexProperty.ENABLE_SPD_SYNC_TO_GLOBAL_TIME, 1);

To set the SPD value from the client side you can set the SPD value with the property SET_PRESENTATION_DELAY as shown below:

mNexPlayer.setProperty(NexProperty.SET_PRESENTATION_DELAY, 10000);

Note that if the value of SET_PRESENTATION_DELAY is too large, the player may not find the delayed segment provided by the live content server. You should optimise the presentation delay according to your use case.

Advanced configuration

You can control the synchronization behaviour further by adjusting the below properties.

Synchronization Accuracy

By default, our synchronization feature depends on the server time, which is only in seconds. When this option is turned on, device time will be used instead. This property makes the synchronization more accurate as it is in milliseconds but keep in mind that if the device time is not set correctly, there might be discrepancies between different devices.

mNexPlayer.setProperty(NexPlayer.NexProperty.ENABLE_SPD_SYNC_TO_DEVICE_TIME, 1);

Default: 0

Values:

  • 0: Disabled
  • 1: Enabled

Synchronization Speed Control Range

Player will keep the synchronization by controlling the playback speed as long as the playback position is within this range. You can adjust this threshold with the SET_SPD_SYNC_DIFF_TIME property.

mNexPlayer.setProperty(NexPlayer.NexProperty.SET_SPD_SYNC_DIFF_TIME, 500);

Unit: msec (1/1000 sec)

Default: 300 (300 msec)

Synchronization Seek Range

If playback is out of synchronization more than this value, the player will make a seek to synchronize the video rather than changing the playback speed.

mNexPlayer.setProperty(NexPlayer.NexProperty.SET_SPD_TOO_MUCH_DIFF_TIME,5000);

Unit: msec (1/1000 sec)

Default: 5000 (5 seconds)

Requirements

  • Our NexPlayer Android SDK supports Android 4.4 and above but the NexPlayer Multiview feature requires a high-end device as it depends on the device performance. At least Android 10+ should be targeted and device performance should be considered.

  • You should make sure there is enough distance from the live edge to provide a smooth playback which should be adjusted with suggestedPresentationDelay and SET_PRESENTATION_DELAY properties. If there is not enough space to buffer from the live edge, playback might be affected.

  • In case Widevine DRM is enabled, Widevine Level 3 should be allowed on the DRM Server.

  • Video encoders should be synchronized and should be embedding correct timestamp for the video streams

  • For HLS, you should set the SET_PRESENTATION_DELAY property as mentioned above.