Codeqo's Native Plugins

NativeMediaPlayer offers easy UI implementations with pre-coded scripts with easy-to-use custom inspectors. Create an empty object in Unity hierarchy and add component to find one of the UI scripts outlined below.

• Media Button makes it easy to create your own media button such as play, pause, stop, loop, shuffle and more
• Volume Bar makes it easy to create your own volume bar
• Seek Bar makes it easy to create your own seek bar
• UI Settings manages shared properties that apply to all UI elements listed above

Media Button

Media Button is an All-In-One component that can create all buttons that NativeMediaPlayer currently supports like the image below.

Choose Button Type to determine which button it is, and put in the necessary components such as Image and Events. Button colors are defined with UI Settings, and check Dark Mode if you want to use the Dark Mode colors.

Volume Bar

To create a volume bar, create a Unity built-in slider and put that into Volume Bar. The slider will behave as volume bar of the NativeMediaPlayer. In case you need events, add the events to the slider.

Seek Bar

Seek Bar also needs a Unity built-in slider. Create a slider and put it into Seek Bar. The slider will behave as seek bar of the NativeMediaPlayer. Update Interval is how often seek bar will be updated, and the default value is 0.5f which means that it will be updated every 0.5 seconds. You can add texts that will display the current position and the duration of the current media item.

UI Settings

UI Settings manages all shared properties of NativeMediaPlayer UI elements. It only manages UI colors in the current version.

Playlist is a basic media source type that manages multiple media items for NativeMediaPlayer. It can only have one UriType which determines which native player the plugin is going to use, and pass the media data to the corresponding player. To add a new MediaItem to Playlist, simply click on the 'Add a new media item' button in the inspector menu.

If you are using StreamingAssets, drag the file directly into the box under 'Put in a file from StreamingAssets folder below'. The inspector will automatically detect the filename and use it as MediaUri of the media item. If you are using RemoteUrl, the box becomes a textbox where you can enter the URL.

NativeMediaPlayer will try to retrieve the media metadata using native APIs by the default, but you can also choose to customize media metadata and prevent from triggering those native APIs. Choosing custom media metadata will expand the inspector menu and show editable property fields of each metadata.

Modifying the playlist

It’s possible to dynamically modify a playlist by adding, and removing media items. This can be done both before and during playback by calling the corresponding playlist API methods:

// Adds a media item at position 1 in the playlist.
playlist.AddMediaItem(1, new MediaItem(uriType, mediaUri));

// Removes the first item from the playlist.
playlist.RemoveMediaItem(0);

Querying the media items

Media items contained in a playlist can be individually queried using playlist.MediaItem[id].

// Quering title of the first item from the playlist.
string title = playlist.MediaItem[0].Title;

Methods

using NativeMediaPlayerCenter;

Parameters

MediaEventListener receives native callbacks. A game object with MediaEventListener.cs must be in the scene for the plugin to work properly. The chart below explains how the callbacks work in order.

Namespace

using NativeMediaPlayerCenter;

Listeners

Methods