Skip to main content

Initialization Configuration

info

As of 2023, Samsung states that Tizen TV's are not optimized for .NET applications. Samsung strongly recommends using JS/Web applications instead of C#/.NET applications for TVs. Please check the Lura Player Web SDK

During initialization, parameters such as autoplay, muted, volume, and loop attributes can be configured. However, it is also possible to modify the volume and muted attributes at a later time, as per requirements.

Media Initialization Configuration

The initialization configuration can set preferred video, caption, and audio behavior when playback starts. These preferences are applied on supported platforms.

AttributeTypeDescription
videoobjectInitial ABR, bitrate, and latency settings.
captionobjectInitial caption display, language, and source settings.
audioobjectInitial audio language settings.
Media Initialization Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

Window window = Window.Instance;
var player = new Player(window);

var config = new Configuration
{
Initialization = new InitializationConfiguration
{
Video = new VideoInitializationConfiguration
{
AbrEnabled = true,
PreferredBitrate = 1000000,
LatencyMode = LatencyModes.Default
},
Caption = new CaptionInitializationConfiguration
{
Enabled = true,
PreferredLanguage = "en",
Source = new[] { "manifest", "embedded" }
},
Audio = new AudioInitializationConfiguration
{
PreferredLanguage = "en"
}
}
};

await player.SetConfig(config);
player.Play();
AttributeTypeDescription
initialization.video.abrEnabledboolEnables or disables ABR on supported platforms.
initialization.video.preferredBitratelongPreferred starting bitrate on supported platforms.
initialization.video.latencyModeLatencyModePreferred latency mode on initialization.
initialization.caption.enabledboolShows or hides captions on initialization.
initialization.caption.preferredLanguagestringPreferred caption language on supported platforms.
initialization.caption.sourcestring[]Caption sources to use. Defaults to ["manifest", "embedded"].
initialization.audio.preferredLanguagestringPreferred audio language on supported platforms.

Autoplay Configuration

The implementation of autoplay attribute can be done in Lura Player using the following configuration.

AttributeTypeDescription
autoplayboolAutoplay attribute of the player. Defaults to false
Autoplay Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

// Initialize player
Window window = Window.Instance;
var player = new Player(window);

// Configure with autoplay enabled
var config = new Configuration
{
Controls = new ControlsConfiguration
{
Autoplay = true
}
};

// Set configuration
await player.SetConfig(config);
player.Play();

Mute Configuration

The implementation of initially muted attribute can be done in Lura Player using the following configuration.

AttributeTypeDescription
mutedboolWhether to start muted when the player autoplays. Defaults to false.
info

Some platforms doesn't support unmuted autoplay. So if autoplay attribute is set to true, muted attribute will be overwritten to true in platforms that doesn't support unmuted autoplay.

Mute Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

// Initialize player
Window window = Window.Instance;
var player = new Player(window);

// Configure with muted enabled
var config = new Configuration
{
Controls = new ControlsConfiguration
{
Muted = true
}
};

// Set configuration
await player.SetConfig(config);
player.Play();

Volume Configuration

The implementation of initial volume attribute can be done in Lura Player using the following configuration.

AttributeTypeDescription
volumefloatInitial volume of the player between 0.0 and 1.0. Defaults to 1.0
Volume Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

// Initialize player
Window window = Window.Instance;
var player = new Player(window);

// Configure with volume
var config = new Configuration
{
Controls = new ControlsConfiguration
{
Volume = 1.0f
}
};

// Set configuration
await player.SetConfig(config);
player.Play();

Loop Configuration

The implementation of loop attribute can be done in Lura Player using the following configuration.

AttributeTypeDescription
loopboolLoop the video when it ends. Defaults to false.
Loop Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

// Initialize player
Window window = Window.Instance;
var player = new Player(window);

// Configure with loop enabled
var config = new Configuration
{
Controls = new ControlsConfiguration
{
Loop = true
}
};

// Set configuration
await player.SetConfig(config);
player.Play();
Combined Example
using Lura;
using Lura.Unified;
using Tizen.NUI;

// Initialize player
Window window = Window.Instance;
var player = new Player(window);

// Configure with autoplay, muted, and volume
var config = new Configuration
{
Controls = new ControlsConfiguration
{
Autoplay = true,
Muted = true,
Volume = 1.0f,
Loop = true
}
};

// Set configuration
await player.SetConfig(config);
player.Play();