com.aliyun.player

Class AliPlayerFactory

java.lang.Object

com.aliyun.player.AliPlayerFactory

public class AliPlayerFactory
extends java.lang.Object

Player factory class for creating different types of player instances.

Provides entry points for standard, playlist, and live timeshift players.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AliPlayerFactory.BlackType decoding blacklist type enumeration.
static class	AliPlayerFactory.DeviceInfo Device information class.
static class	AliPlayerFactory.SupportFeatureType Device feature support type enumeration.

Constructor Summary

Constructors

Constructor and Description
AliPlayerFactory()

Method Summary

Modifier and Type	Method and Description
static void	addBlackDevice(AliPlayerFactory.BlackType blackType, AliPlayerFactory.DeviceInfo deviceInfo) Adds a single device to the hardware decoding blacklist.
static void	addBlackList(AliPlayerFactory.BlackType blackType, java.util.List<AliPlayerFactory.DeviceInfo> deviceInfos) Adds multiple devices to the hardware decoding blacklist in batch.
static AliListPlayer	createAliListPlayer(android.content.Context context) Creates a playlist player instance (without trace ID overload).
static AliListPlayer	createAliListPlayer(android.content.Context context, java.lang.String traceId) Creates a playlist player instance (with trace ID overload).
static AliLiveShiftPlayer	createAliLiveShiftPlayer(android.content.Context context) Creates a broadcast timeshift player instance (without trace ID overload).
static AliLiveShiftPlayer	createAliLiveShiftPlayer(android.content.Context context, java.lang.String traceId) Creates a broadcast timeshift player instance (with trace ID overload).
static AliPlayer	createAliPlayer(android.content.Context context) Creates a standard player instance.
static AliPlayer	createAliPlayer(android.content.Context context, java.lang.String traceId) Creates a standard player instance with a trace ID for log tracing.
static java.lang.String	getDeviceUUID() Retrieves the device unique identifier (UUID).
static java.lang.String	getSdkVersion() Retrieves the player SDK version number.
static boolean	isFeatureSupport(AliPlayerFactory.SupportFeatureType type) Queries whether the device supports a specified advanced feature.
static void	setConvertURLCallback(IPlayer.ConvertURLCallback callback) Sets the URL conversion callback.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AliPlayerFactory

public AliPlayerFactory()

Method Detail

createAliPlayer

public static AliPlayer createAliPlayer(android.content.Context context)

Creates a standard player instance.

Parameters:

context - Application context

Returns:

AliPlayer instance

createAliPlayer

public static AliPlayer createAliPlayer(android.content.Context context,
                                        java.lang.String traceId)

Creates a standard player instance with a trace ID for log tracing.

Parameters:

context - Application context

traceId - Trace ID; set to "DisableAnalytics" to disable analytics (not recommended)

Returns:

AliPlayer instance

createAliListPlayer

public static AliListPlayer createAliListPlayer(android.content.Context context)

Creates a playlist player instance (without trace ID overload).

Playlist players are suitable for scenarios involving continuous playback of multiple media sources, such as short video lists or carousels.

Parameters:

context - Application context used to initialize system services required by the player

Returns:

A newly created AliListPlayer instance

See Also:

AliListPlayer

createAliListPlayer

public static AliListPlayer createAliListPlayer(android.content.Context context,
                                                java.lang.String traceId)

Creates a playlist player instance (with trace ID overload).

Playlist players are suitable for scenarios involving continuous playback of multiple media sources.

Note: Setting traceId to "DisableAnalytics" disables log analytics reporting, which may impair troubleshooting capabilities and is not recommended in production.

Parameters:

context - Application context used to initialize system services required by the player

traceId - Log tracing identifier to correlate logs from the same business scenario; set to "DisableAnalytics" to disable analytics (not recommended)

Returns:

A newly created AliListPlayer instance

See Also:

AliListPlayer

createAliLiveShiftPlayer

public static AliLiveShiftPlayer createAliLiveShiftPlayer(android.content.Context context)

Creates a broadcast timeshift player instance (without trace ID overload).

Broadcast timeshift players support operations like rewind, pause, and fast-forward on live streams.

Parameters:

context - Application context used to initialize system services required by the player

Returns:

A newly created AliLiveShiftPlayer instance

See Also:

AliLiveShiftPlayer

createAliLiveShiftPlayer

public static AliLiveShiftPlayer createAliLiveShiftPlayer(android.content.Context context,
                                                          java.lang.String traceId)

Creates a broadcast timeshift player instance (with trace ID overload).

Broadcast timeshift players support operations like rewind, pause, and fast-forward on live streams.

Parameters:

context - Application context used to initialize system services required by the player

traceId - Log tracing identifier to correlate logs from the same business scenario

Returns:

A newly created AliLiveShiftPlayer instance

See Also:

AliLiveShiftPlayer

getSdkVersion

public static java.lang.String getSdkVersion()

Retrieves the player SDK version number.

Returns:

SDK version number string

addBlackDevice

public static void addBlackDevice(AliPlayerFactory.BlackType blackType,
                                  AliPlayerFactory.DeviceInfo deviceInfo)

Adds a single device to the hardware decoding blacklist.

If the current device model matches deviceInfo.model and meets API level requirements, the corresponding hardware decoding feature is disabled.

Note: This method should be called before creating player instances, otherwise it may have no effect.

Parameters:

blackType - Blacklist type, see AliPlayerFactory.BlackType

deviceInfo - Device information object containing the model to blacklist; ignored if null

See Also:

AliPlayerFactory.BlackType, AliPlayerFactory.DeviceInfo

addBlackList

public static void addBlackList(AliPlayerFactory.BlackType blackType,
                                java.util.List<AliPlayerFactory.DeviceInfo> deviceInfos)

Adds multiple devices to the hardware decoding blacklist in batch.

Calls addBlackDevice(BlackType, DeviceInfo) for each device info in the list.

Parameters:

blackType - Blacklist type, see AliPlayerFactory.BlackType

deviceInfos - List of device information objects; ignored if null

See Also:

AliPlayerFactory.BlackType, AliPlayerFactory.DeviceInfo, addBlackDevice(BlackType, DeviceInfo)

setConvertURLCallback

public static void setConvertURLCallback(IPlayer.ConvertURLCallback callback)

Sets the URL conversion callback.

Parameters:

callback - URL conversion callback instance; set to null to unregister

See Also:

IPlayer.ConvertURLCallback

getDeviceUUID

public static java.lang.String getDeviceUUID()

Retrieves the device unique identifier (UUID).

This UUID is randomly generated on the first app launch and remains unchanged thereafter, useful for device-level log tracing.

Note: This UUID is unrelated to Android system IDs and is only valid within the current application.

Returns:

Device unique identifier string

isFeatureSupport

public static boolean isFeatureSupport(AliPlayerFactory.SupportFeatureType type)

Queries whether the device supports a specified advanced feature.

Currently only supports querying AliPlayerFactory.SupportFeatureType.FeatureDolbyAudio.

Parameters:

type - Feature support type, see AliPlayerFactory.SupportFeatureType

Returns:

true if the device supports the feature, false otherwise

See Also:

AliPlayerFactory.SupportFeatureType