Skip to main content

SpecsPlayer

Reference for SpecsPlayer, the SPECS NDK high-level media player that runs the full decode pipeline for files, URLs, memory and live video devices.

SpecsPlayer is the high-level media player for SPECS. It handles the full decode pipeline (container, video codec, audio codec, and output) internally. Most applications should start with SpecsPlayer rather than SpecsMedia.

#include <SpecsPlayer.h>
target_link_libraries(myapp specs_player)

INTERNET: SpecsPlayer_open and SpecsPlayer_openWithOptions are annotated with SPECS_REQUIRES_PERMISSION(INTERNET). The permission is recorded in your library's .snap.permissions manifest at build time; see Permission Annotations and Manifest Embedding.

When to use SpecsPlayer or SpecsMedia

Use SpecsPlayer when you needUse SpecsMedia when you need
Playing a file or URL end-to-endYou need raw compressed samples
You want automatic decode pipelineCustom rendering pipeline
Play, pause, and seek controlTranscoding or frame extraction
Frame or audio delivery via callbackStreaming to custom buffers

Player lifecycle

[NULL state]
│
├─ SpecsPlayer_create()
│
[NULL state — player handle valid]
│
├─ SpecsPlayer_setEventCallback() ← MUST be before open()
├─ SpecsPlayer_setVideoOutputMode() ← MUST be before open()
├─ SpecsPlayer_setAudioOutputMode() ← MUST be before open()
├─ SpecsPlayer_setVideoFrameCallback() ← MUST be before open()
├─ SpecsPlayer_setAudioCallback() ← MUST be before open()
│
├─ SpecsPlayer_open() / SpecsPlayer_openFromMemory()
│
[READY state]
│ ├─ setVolume() / getShouldLoop() / etc. — valid here
│
├─ SpecsPlayer_play() / SpecsPlayer_playAsync()
│
[PLAYING state]
│
├─ SpecsPlayer_pause() / SpecsPlayer_pauseAsync()
│
[PAUSED state]
│
├─ SpecsPlayer_play() / SpecsPlayer_playAsync() ← resume
├─ SpecsPlayer_stop() / SpecsPlayer_stopAsync() → [READY state]
│
[READY state]
│
├─ SpecsPlayer_close()
│
[NULL state]
│
└─ SpecsPlayer_destroy()

Setup ordering rules for SpecsPlayer. Violating these returns SPECSPLAYER_ERROR_INVALID_STATE:

FunctionMust be called
setEventCallback()Before open()
setVideoOutputMode()Before open()
setAudioOutputMode()Before open()
setVideoFrameCallback()Before open()
setAudioCallback()Before open()
setVolume()After open()
setShouldLoop()After open()
seek()While PLAYING or PAUSED
getDuration() / getPosition()While PLAYING or PAUSED
getMediaProperty*()While PLAYING or PAUSED

Result codes

SpecsPlayer functions return a SpecsPlayer_Result_t:

// Since: v1.3.0
typedef enum SpecsPlayer_Result_t {
SPECSPLAYER_SUCCESS = 0,
SPECSPLAYER_ERROR_GENERIC = 1,
SPECSPLAYER_ERROR_INVALID_PARAM = 2,
SPECSPLAYER_ERROR_INVALID_STATE = 3,
SPECSPLAYER_ERROR_NETWORK = 4,
SPECSPLAYER_ERROR_FORMAT = 5,
SPECSPLAYER_ERROR_NOT_SUPPORTED = 6,
SPECSPLAYER_ERROR_NO_HANDLER = 7,
SPECSPLAYER_ERROR_RESOURCE_EXHAUSTED = 8
} SpecsPlayer_Result_t;
CodeValueMeaning
SPECSPLAYER_SUCCESS0Operation succeeded
SPECSPLAYER_ERROR_GENERIC1Unspecified internal error
SPECSPLAYER_ERROR_INVALID_PARAM2NULL or out-of-range argument
SPECSPLAYER_ERROR_INVALID_STATE3Function called in wrong lifecycle state
SPECSPLAYER_ERROR_NETWORK4Network failure (http/https sources)
SPECSPLAYER_ERROR_FORMAT5Media format not supported or corrupt
SPECSPLAYER_ERROR_NOT_SUPPORTED6Feature not supported
SPECSPLAYER_ERROR_NO_HANDLER7No handler registered for event type
SPECSPLAYER_ERROR_RESOURCE_EXHAUSTED8Required resources exhausted—release unused resources (for example other players/presenters) before retrying

Types

SpecsPlayer_t

Since: v1.3.0

The opaque player handle. Every SpecsPlayer function takes a SpecsPlayer_t created by SpecsPlayer_create().

typedef struct SpecsPlayer_t SpecsPlayer_t;

SpecsPlayer_Config_t

Since: v1.3.0

typedef struct {
const char *app_name; // identifier for logging/debugging; may be NULL
} SpecsPlayer_Config_t;

SpecsPlayer_State_t

Since: v1.3.0

typedef enum {
SPECSPLAYER_STATE_NULL = 0, // initial / after close
SPECSPLAYER_STATE_READY = 1, // after open, after stop
SPECSPLAYER_STATE_PAUSED = 2,
SPECSPLAYER_STATE_PLAYING = 3
} SpecsPlayer_State_t;

SpecsPlayer_EventType_t

Since: v1.3.0

typedef enum {
SPECSPLAYER_EVENT_STATE_CHANGED = 0,
SPECSPLAYER_EVENT_ERROR = 1,
SPECSPLAYER_EVENT_END_OF_STREAM = 2,
SPECSPLAYER_EVENT_BUFFERING = 3,
SPECSPLAYER_EVENT_DURATION_CHANGED = 4
} SpecsPlayer_EventType_t;

SpecsPlayer_Event_t

Since: v1.3.0

typedef struct {
SpecsPlayer_EventType_t type;
union {
struct { SpecsPlayer_State_t old_state, new_state; } state_changed;
struct { SpecsPlayer_Result_t error_code; const char *message; } error;
struct { int percent; } buffering;
struct { double duration; } duration_changed;
} data;
} SpecsPlayer_Event_t;

Video output modes

// Since: v1.3.0
typedef enum {
SPECSPLAYER_VIDEO_OUTPUT_NONE = 0, // disable video decode
SPECSPLAYER_VIDEO_OUTPUT_DISPLAY = 1, // render to display (default)
SPECSPLAYER_VIDEO_OUTPUT_CALLBACK = 2, // deliver CPU-readable frames to callback only
SPECSPLAYER_VIDEO_OUTPUT_CALLBACK_MEDIA_BUFFER = 3 // deliver borrowed
// SpecsMediaBuffer frames to callback
// (zero-copy; no CPU mapping)
} SpecsPlayer_VideoOutputMode_t;

SPECSPLAYER_VIDEO_OUTPUT_CALLBACK_MEDIA_BUFFER delivers each frame as a borrowed SpecsMediaBuffer in frame->media_buffer without CPU-mapping the frame data. The SPECSPLAYER_VIDEO_OUTPUT_CALLBACK mode delivers CPU-readable frames (populated data/stride/plane_*). In media-buffer mode the buffer is valid only during the callback unless the client takes a reference with SpecsMediaBuffer_acquire().

SpecsPlayer_FrameFormat_t

Since: v1.3.0

typedef enum {
SPECSPLAYER_FRAME_FORMAT_UNKNOWN = 0,
SPECSPLAYER_FRAME_FORMAT_I420 = 1, // YUV 4:2:0 planar
SPECSPLAYER_FRAME_FORMAT_NV12 = 2, // YUV 4:2:0 semi-planar
SPECSPLAYER_FRAME_FORMAT_RGBA = 3 // RGBA 8-bit
} SpecsPlayer_FrameFormat_t;

SpecsPlayer_Frame_t

Since: v1.3.0

typedef struct {
int width, height; // pixels
double pts; // presentation timestamp (seconds)
double duration; // frame duration (seconds)
SpecsPlayer_FrameFormat_t format;
const uint8_t *data; // valid only during callback
size_t size; // total bytes
int stride; // row stride of first plane (bytes)
size_t plane_offsets[3]; // for multi-plane formats (NV12, I420): offsets from data
int plane_strides[3]; // for multi-plane formats (NV12, I420): per-plane stride
SpecsMediaBuffer *media_buffer; // borrowed buffer; non-NULL only in
// SPECSPLAYER_VIDEO_OUTPUT_CALLBACK_MEDIA_BUFFER
// mode. Valid only during the callback unless
// SpecsMediaBuffer_acquire() is called.
} SpecsPlayer_Frame_t;

Audio output modes

// Since: v1.3.0
typedef enum {
SPECSPLAYER_AUDIO_OUTPUT_NONE = 0, // disable audio decode
SPECSPLAYER_AUDIO_OUTPUT_SPEAKER = 1, // output to audio service (default)
SPECSPLAYER_AUDIO_OUTPUT_CALLBACK = 2 // deliver to audio callback only
} SpecsPlayer_AudioOutputMode_t;

SpecsPlayer_AudioFormat_t

Since: v1.3.0

typedef enum {
SPECSPLAYER_AUDIO_FORMAT_UNKNOWN = 0,
SPECSPLAYER_AUDIO_FORMAT_S16LE = 1, // signed 16-bit little-endian
SPECSPLAYER_AUDIO_FORMAT_S32LE = 2, // signed 32-bit little-endian
SPECSPLAYER_AUDIO_FORMAT_F32LE = 3 // float 32-bit little-endian
} SpecsPlayer_AudioFormat_t;

SpecsPlayer_AudioSample_t

Since: v1.3.0

typedef struct {
int sample_rate, channels;
double pts, duration; // seconds
SpecsPlayer_AudioFormat_t format;
const uint8_t *data; // valid only during callback
size_t size;
void *_internal;
} SpecsPlayer_AudioSample_t;

Media properties

Query SpecsPlayer media properties while the player is in PLAYING or PAUSED state.

// Since: v1.3.0
typedef enum {
// Stream availability (int: 1 = present, 0 = not present)
SPECSPLAYER_PROP_HAS_VIDEO = 0,
SPECSPLAYER_PROP_HAS_AUDIO = 1,

// Video (int/double/string as noted)
SPECSPLAYER_PROP_VIDEO_WIDTH = 100, // int: pixels
SPECSPLAYER_PROP_VIDEO_HEIGHT = 101, // int: pixels
SPECSPLAYER_PROP_VIDEO_FRAMERATE = 102, // double: fps
SPECSPLAYER_PROP_VIDEO_CODEC = 103, // string: e.g. "h264", "h265"

// Audio
SPECSPLAYER_PROP_AUDIO_SAMPLE_RATE = 200, // int: Hz
SPECSPLAYER_PROP_AUDIO_CHANNELS = 201, // int
SPECSPLAYER_PROP_AUDIO_CODEC = 202 // string: e.g. "aac", "opus"
} SpecsPlayer_MediaProperty_t;

Function reference

Lifecycle

// Create a new player instance.
// cfg->app_name may be NULL.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_create(SpecsPlayer_t **player,
const SpecsPlayer_Config_t *cfg);

// Destroy player and free all resources. Sets *player to NULL.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_destroy(SpecsPlayer_t **player);

Open and close

// Open a media URL. Supported schemes: file://, http://, https://
// Must call setEventCallback() and set output modes before this.
// Can return SPECSPLAYER_ERROR_RESOURCE_EXHAUSTED if required resources are
// exhausted — release unused resources before retrying.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_open(SpecsPlayer_t *player, const char *url);

// Open a media URL with optional request configuration (e.g. HTTP headers).
// Pass NULL for `options` to behave exactly like SpecsPlayer_open().
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_openWithOptions(SpecsPlayer_t *player,
const char *url,
const SpecsPlayer_OpenOptions_t *options);

// Open from an in-memory buffer.
// The buffer MUST remain valid and unchanged until close() or destroy().
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_openFromMemory(SpecsPlayer_t *player,
const uint8_t *data,
size_t size);

// Open a live video device source (e.g. external video input via cable).
// Output is routed through the configured video/audio output modes and callbacks.
// In video device mode, the following return SPECSPLAYER_ERROR_NOT_SUPPORTED:
// pause/pauseAsync, seek, setShouldLoop/getShouldLoop, getDuration, getPosition.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_openFromVideoDevice(
SpecsPlayer_t *player,
const SpecsPlayer_VideoDeviceConfig_t *config);

// Close the current media and tear down the pipeline.
// No more events will be emitted after this returns.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_close(SpecsPlayer_t *player);

Open options (HTTP headers)

SpecsPlayer_openWithOptions() lets you attach custom HTTP headers (for example Authorization) to URL-based media requests. Headers are copied during the call, so the caller may free the array as soon as it returns. They are applied to the initial HTTP source request and, when the platform GStreamer build supports it, to adaptive-streaming internal requests (HLS playlists, fragments, keys, and preload requests).

// Since: v1.3.0
typedef struct SpecsPlayer_HttpHeader_t {
const char *name; // e.g. "Authorization"
const char *value; // e.g. "Bearer <token>"
} SpecsPlayer_HttpHeader_t;

// Since: v1.3.0
typedef struct SpecsPlayer_OpenOptions_t {
const SpecsPlayer_HttpHeader_t *http_headers; // array of headers (copied)
size_t http_header_count;
} SpecsPlayer_OpenOptions_t;

Video device source

// Since: v1.3.0
typedef enum {
SPECSPLAYER_VIDEO_DEVICE_EXTERNAL_INPUT = 0, // external video input via cable
// (video + audio)
} SpecsPlayer_VideoDevice_t;

// Since: v1.3.0
typedef struct {
SpecsPlayer_VideoDevice_t device;
} SpecsPlayer_VideoDeviceConfig_t;

The SpecsPlayer video device source captures from a live device rather than a file/URL/buffer. It is intended for use cases such as feeding an external HDMI/cable input through the player. Because the source is live, seeking, pausing, looping, and duration/position queries are not supported.

Playback control

// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_play(SpecsPlayer_t *player);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_pause(SpecsPlayer_t *player);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_stop(SpecsPlayer_t *player);

// Async (fire-and-forget) versions — queue the request and return immediately.
// Completion or failure is reported via SPECSPLAYER_EVENT_STATE_CHANGED or
// SPECSPLAYER_EVENT_ERROR event callbacks.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_playAsync(SpecsPlayer_t *player);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_pauseAsync(SpecsPlayer_t *player);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_stopAsync(SpecsPlayer_t *player);

// Seek to an absolute position in seconds. Valid once the media is PAUSED or
// PLAYING. Seeking while paused keeps the player paused and delivers the frame
// at the new position to the frame callback. A paused seek to the position the
// player already holds (for example to 0 right after prerolling) succeeds
// without touching the pipeline: no flush, no new frame.
// Values below 0 seek to the start; values past the end of the media seek to
// the end.
// Returns SPECSPLAYER_SUCCESS on success,
// SPECSPLAYER_ERROR_INVALID_PARAM if player is NULL or seconds is NaN or infinite,
// SPECSPLAYER_ERROR_INVALID_STATE if no media is open,
// SPECSPLAYER_ERROR_NOT_SUPPORTED for a video device,
// SPECSPLAYER_ERROR_GENERIC if the media is not yet ready or the seek fails.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_seek(SpecsPlayer_t *player, double seconds);

Configuration (call after open)

// Loop playback at end-of-stream.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setShouldLoop(SpecsPlayer_t *player, bool should_loop);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getShouldLoop(SpecsPlayer_t *player, bool *should_loop);

// Volume: linear [0.0, 1.0]. setVolume returns SPECSPLAYER_ERROR_INVALID_PARAM
// if volume is outside [0.0, 1.0] or NaN.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setVolume(SpecsPlayer_t *player, double volume);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getVolume(SpecsPlayer_t *player, double *volume);

Queries

// Returns 0.0 if not PLAYING or PAUSED.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getDuration(SpecsPlayer_t *player, double *duration);

// Returns 0.0 if no media is open. While media is open but not yet PAUSED or
// PLAYING the position is unknown and SPECSPLAYER_ERROR_INVALID_STATE is
// returned.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getPosition(SpecsPlayer_t *player, double *position);

// Get the active layer ID for DISPLAY output mode. The ID is available after a
// successful open and remains stable through play and pause. Returns
// SPECSPLAYER_ERROR_INVALID_STATE if called before open or after close, or
// SPECSPLAYER_ERROR_GENERIC if video output is not DISPLAY.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getLayerId(SpecsPlayer_t *player, unsigned int *layer_id);

Event callback (call before open)

// Since: v1.3.0
typedef void (*SpecsPlayer_EventCallback_t)(SpecsPlayer_t *player,
const SpecsPlayer_Event_t *event,
void *user_data);

// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setEventCallback(SpecsPlayer_t *player,
SpecsPlayer_EventCallback_t callback,
void *user_data);

Video output (call before open)

// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setVideoOutputMode(SpecsPlayer_t *player,
SpecsPlayer_VideoOutputMode_t mode);

// Since: v1.3.0
typedef void (*SpecsPlayer_FrameCallback_t)(SpecsPlayer_t *player,
const SpecsPlayer_Frame_t *frame,
void *user_data);

// Required when mode == SPECSPLAYER_VIDEO_OUTPUT_CALLBACK or
// SPECSPLAYER_VIDEO_OUTPUT_CALLBACK_MEDIA_BUFFER.
// Frame is valid only during the callback.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setVideoFrameCallback(SpecsPlayer_t *player,
SpecsPlayer_FrameCallback_t callback,
void *user_data);

// Set / get the display layer z-order (DISPLAY output mode only).
// If setZOrder is never called, PlatformGraphics chooses the layer ordering.
// INT32_MIN is reserved and rejected. getZOrder returns
// SPECSPLAYER_ERROR_INVALID_STATE if no custom z-order has been set.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setZOrder(SpecsPlayer_t *player, int32_t z_order);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getZOrder(SpecsPlayer_t *player, int32_t *z_order);

// Show or hide the display layer (DISPLAY output mode only). The layer is
// visible by default. Hiding does not pause playback — decoding and the
// playback clock continue; only the composited output is suppressed.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setLayerVisible(SpecsPlayer_t *player, bool visible);
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getLayerVisible(SpecsPlayer_t *player, bool *visible);

SpecsPlayer_setZOrder() / SpecsPlayer_getZOrder() control the compositor layer z-order for SPECSPLAYER_VIDEO_OUTPUT_DISPLAY output. They mirror the SpecsMediaPresenter_setZOrder() / SpecsMediaPresenter_getZOrder() pair.

SpecsPlayer_setLayerVisible() / SpecsPlayer_getLayerVisible() toggle and query the visibility of the display layer for SPECSPLAYER_VIDEO_OUTPUT_DISPLAY output. Hiding the layer suppresses composited output without pausing playback; the layer is visible by default.

Audio output (call before open)

// Returns SPECSPLAYER_ERROR_INVALID_PARAM for an unknown mode.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setAudioOutputMode(SpecsPlayer_t *player,
SpecsPlayer_AudioOutputMode_t mode);

// Since: v1.3.0
typedef void (*SpecsPlayer_AudioCallback_t)(SpecsPlayer_t *player,
const SpecsPlayer_AudioSample_t *sample,
void *user_data);

// Required when mode == SPECSPLAYER_AUDIO_OUTPUT_CALLBACK.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setAudioCallback(SpecsPlayer_t *player,
SpecsPlayer_AudioCallback_t callback,
void *user_data);

Media property queries (call while PLAYING or PAUSED)

// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getMediaPropertyInt(SpecsPlayer_t *player,
SpecsPlayer_MediaProperty_t property,
int *value);

// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getMediaPropertyDouble(SpecsPlayer_t *player,
SpecsPlayer_MediaProperty_t property,
double *value);

// Returned string is valid until close() or destroy(). Do not free.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_getMediaPropertyString(SpecsPlayer_t *player,
SpecsPlayer_MediaProperty_t property,
const char **value);

Foreground audio session integration (call before open)

Foreground audio session registration is disabled by default. When you enable it with SpecsPlayer_setAudioSessionEnabled(), SpecsPlayer registers itself with the system's foreground audio session coordinator (see SpecsForegroundAudioSession). This lets the system manage audio focus—for example, pause playback when a higher-priority audio source becomes active—and allows the player to publish its playback state to the platform UI.

// Enable or disable (default) foreground audio session registration.
// Must be called before SpecsPlayer_open*().
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setAudioSessionEnabled(SpecsPlayer_t *player,
bool enabled);

Dual-track AR video overlay (call before or after open)

Dual-track AR recordings are MP4 files containing two HEVC tracks in a single container: track 0 is the underlying camera feed and track 1 is the AR overlay. When SpecsPlayer detects this format it builds a compositor pipeline that composites track 1 on top of track 0, with non-dark-key pixels controlled by an opacity parameter. The blend (additive or scrim) is the capture's own: its stored com.snap.overlay_blend_mode with its saved edits applied.

// Since: v1.3.0
typedef struct SpecsPlayer_ArOverlayParams_t {
float alpha; // overlay opacity in [0.0, 1.0]; default: the capture's camera
// alpha with its saved edits applied, or 0.3 when the
// capture records none
} SpecsPlayer_ArOverlayParams_t;

// Configure compositor parameters for dual-track AR playback.
// May be called before or after open*().
// - Before open: parameters are stashed and applied when the next open*() call
// builds a dual-track AR pipeline. If the opened file is not dual-track AR,
// the stashed value has no effect.
// - After open: applied immediately to the live compositor. Returns
// SPECSPLAYER_ERROR_NOT_SUPPORTED if the open media is not dual-track AR;
// use SpecsPlayer_isDualTrackAr() to check first.
// - NULL params resets to defaults.
// Returns SPECSPLAYER_ERROR_INVALID_PARAM if player is NULL or alpha is out of
// range or NaN, SPECSPLAYER_ERROR_NOT_SUPPORTED if a decoder is open and the
// media is not dual-track AR, SPECSPLAYER_ERROR_GENERIC if the live compositor
// failed to accept the value.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_setArOverlayParams(
SpecsPlayer_t *player,
const SpecsPlayer_ArOverlayParams_t *params);

// Query whether the currently open media is a dual-track AR recording.
// Valid after open*(); reflects what the player detected when building its
// pipeline. The value does not change for the lifetime of the open media.
// Since: v1.3.0
SpecsPlayer_Result_t SpecsPlayer_isDualTrackAr(SpecsPlayer_t *player,
bool *is_dual_track);