com.aliyun.player

类 AliPlayerGlobalSettings

java.lang.Object

com.aliyun.player.AliPlayerGlobalSettings

public class AliPlayerGlobalSettings
extends java.lang.Object

嵌套类概要

嵌套类

限定符和类型	类和说明
static interface	AliPlayerGlobalSettings.OnGetBackupUrlCallback
static interface	AliPlayerGlobalSettings.OnGetUrlHashCallback 获取加载url的hash值回调，用来做url唯一的id，必须要保证每个url都不一样
static interface	AliPlayerGlobalSettings.OnNetworkCallback 媒体数据从网络下来后有机会回调出去，可对原始数据进行处理，目前只支持mp4
static class	AliPlayerGlobalSettings.StreamType 音频流类型

字段概要

字段

限定符和类型	字段和说明
static int	ALLOW_BOUNDS_CHANGE_ANIMATION
static int	ALLOW_RTS_DEGRADE
static int	CodecType_H265
static int	DECODER_POOL_CAPACITY_CROSS_INSTANCE
static int	DISABLE_CAPTURE_SCALE
static int	ENABLE_ANDROID_DECODE_REUSE
static int	ENABLE_DECODER_FAST_FIRST_FRAME
static int	ENABLE_DECODER_REUSE_CROSS_INSTANCE
static int	ENABLE_H2_MULTIPLEX
static int	NOT_PAUSE_WHEN_PREPARING
static int	SCENE_LOADER
static int	SCENE_PLAYER
static int	SET_DNS_PRIORITY_LOCAL_FIRST
static int	SET_EXTRA_DATA
static int	SET_PRE_CONNECT_DOMAIN

构造器概要

构造器

构造器和说明
AliPlayerGlobalSettings()

方法概要

限定符和类型	方法和说明
static void	clearCaches() 清空所有的缓存文件
static void	disableCrashUpload(boolean disable)
static void	enableBufferToLocalCache(boolean enable)
static void	enableEnhancedHttpDns(boolean enable) 是否开启增强型httpDNS。
static void	enableHttpDns(boolean enable) 已过时。
static java.lang.String	enableLocalCache(boolean enable, android.content.Context context) 开启本地缓存，开启之后，就会缓存到本地文件中。
static void	enableLocalCache(boolean enable, int maxBufferMemoryKB, java.lang.String localCacheDir) 开启本地缓存，开启之后，就会缓存到本地文件中。
static void	enableNetworkBalance(boolean enable) 是否开启内建预加载网络平衡策略，播放过程中，自动控制预加载的运行时机。
static void	forceAudioRendingFormat(boolean force, java.lang.String format, int channels, int sample_rate) 强制音频渲染器采用指定的格式进行渲染，如果设定的格式设备不支持，则无效，无效值将被忽略，使用默认值；pcm回调数据的格式和此设置关联,如果修改，请在同一个线程操作,默认关闭
static void	loadClass()
static void	setAdaptiveDecoderGetBackupURLCallback(AliPlayerGlobalSettings.OnGetBackupUrlCallback cb) 设置取备用url的回调。
static void	setAudioStreamType(AliPlayerGlobalSettings.StreamType streamType) 设置音频播放类型
static void	setCacheFileClearConfig(long expireMin, long maxCapacityMB, long freeStorageMB) 本地缓存文件自动清理相关的设置
static void	setCacheUrlHashCallback(AliPlayerGlobalSettings.OnGetUrlHashCallback cb) 设置加载url的hash值回调。
static void	setDNSResolve(java.lang.String host, java.lang.String ip) 设置域名对应的解析ip
static void	setIPResolveType(IPlayer.IPResolveType type) 设置网络ip解析类型
static void	setNetworkCallback(AliPlayerGlobalSettings.OnNetworkCallback cb) 设置网络数据回调。
static void	setOption(int key, int value) 设置特定功能选项
static void	setOption(int key, java.lang.String value) 设置特定功能选项
static void	setUseHttp2(boolean use) 设置是否使用http2。

从类继承的方法 java.lang.Object

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

字段详细资料

SET_PRE_CONNECT_DOMAIN

public static final int SET_PRE_CONNECT_DOMAIN

另请参阅:

常量字段值

SET_DNS_PRIORITY_LOCAL_FIRST

public static final int SET_DNS_PRIORITY_LOCAL_FIRST

另请参阅:

常量字段值

ENABLE_H2_MULTIPLEX

public static final int ENABLE_H2_MULTIPLEX

另请参阅:

常量字段值

SET_EXTRA_DATA

public static final int SET_EXTRA_DATA

另请参阅:

常量字段值

ENABLE_ANDROID_DECODE_REUSE

public static final int ENABLE_ANDROID_DECODE_REUSE

另请参阅:

常量字段值

NOT_PAUSE_WHEN_PREPARING

public static final int NOT_PAUSE_WHEN_PREPARING

另请参阅:

常量字段值

ALLOW_RTS_DEGRADE

public static final int ALLOW_RTS_DEGRADE

另请参阅:

常量字段值

ENABLE_DECODER_FAST_FIRST_FRAME

public static final int ENABLE_DECODER_FAST_FIRST_FRAME

另请参阅:

常量字段值

DISABLE_CAPTURE_SCALE

public static final int DISABLE_CAPTURE_SCALE

另请参阅:

常量字段值

ENABLE_DECODER_REUSE_CROSS_INSTANCE

public static final int ENABLE_DECODER_REUSE_CROSS_INSTANCE

另请参阅:

常量字段值

DECODER_POOL_CAPACITY_CROSS_INSTANCE

public static final int DECODER_POOL_CAPACITY_CROSS_INSTANCE

另请参阅:

常量字段值

ALLOW_BOUNDS_CHANGE_ANIMATION

public static final int ALLOW_BOUNDS_CHANGE_ANIMATION

另请参阅:

常量字段值

SCENE_PLAYER

public static final int SCENE_PLAYER

另请参阅:

常量字段值

SCENE_LOADER

public static final int SCENE_LOADER

另请参阅:

常量字段值

CodecType_H265

public static final int CodecType_H265

另请参阅:

常量字段值

构造器详细资料

AliPlayerGlobalSettings

public AliPlayerGlobalSettings()

方法详细资料

loadClass

public static void loadClass()

setOption

public static void setOption(int key,
                             java.lang.String value)

设置特定功能选项

参数:

key - 选项key

value - 选项的值

setOption

public static void setOption(int key,
                             int value)

设置特定功能选项

参数:

key - 选项key

value - 选项的值

setDNSResolve

public static void setDNSResolve(java.lang.String host,
                                 java.lang.String ip)

设置域名对应的解析ip

参数:

host - 域名，需指定端口（http默认端口80，https默认端口443）。例如player.alicdn.com:80

ip - 相应的ip，设置为空字符串清空设定。

setUseHttp2

public static void setUseHttp2(boolean use)

设置是否使用http2。自从v5.5.0.0开始默认打开

参数:

use - true：使用。

setIPResolveType

public static void setIPResolveType(IPlayer.IPResolveType type)

设置网络ip解析类型

参数:

type - 见 IPlayer.IPResolveType

setAudioStreamType

public static void setAudioStreamType(AliPlayerGlobalSettings.StreamType streamType)

设置音频播放类型

参数:

streamType - 见 AliPlayerGlobalSettings.StreamType

forceAudioRendingFormat

public static void forceAudioRendingFormat(boolean force,
                                           java.lang.String format,
                                           int channels,
                                           int sample_rate)

强制音频渲染器采用指定的格式进行渲染，如果设定的格式设备不支持，则无效，无效值将被忽略，使用默认值；pcm回调数据的格式和此设置关联,如果修改，请在同一个线程操作,默认关闭

参数:

force - 打开/关闭 强制设置

format - 设置pcm的格式，目前只支持s16，16位有符号整数

channels - 设置pcm的声道数，有效值 1~2

sample_rate - 设置pcm的采样率，有效值 1～48000

enableLocalCache

public static java.lang.String enableLocalCache(boolean enable,
                                                android.content.Context context)

开启本地缓存，开启之后，就会缓存到本地文件中。

参数:

enable - true：开启本地缓存。false：关闭。默认关闭。

enableLocalCache

public static void enableLocalCache(boolean enable,
                                    int maxBufferMemoryKB,
                                    java.lang.String localCacheDir)

开启本地缓存，开启之后，就会缓存到本地文件中。

参数:

enable - true：开启本地缓存。false：关闭。默认关闭。

maxBufferMemoryKB - 该参数已经弃用。 设置单个源的最大内存占用大小。单位KB

localCacheDir - 本地缓存的文件目录，绝对路径

setCacheFileClearConfig

public static void setCacheFileClearConfig(long expireMin,
                                           long maxCapacityMB,
                                           long freeStorageMB)

本地缓存文件自动清理相关的设置

参数:

expireMin - 缓存多久过期：单位分钟，默认值30天，过期的缓存不管容量如何，都会在清理时淘汰掉；

maxCapacityMB - 最大缓存容量：单位兆，默认值2GB，在清理时，如果缓存总大小超过此大小，会以cacheItem为粒度，按缓存的最后时间排序，一个一个淘汰掉一些缓存，直到小于等于最大缓存容量；推荐短视频业务设置最大缓存容量为500MB；

freeStorageMB - 磁盘最小空余容量：单位兆，默认值1GB，在清理时，同最大缓存容量，如果当前磁盘容量小于该值，也会按规则一个一个淘汰掉一些缓存，直到freeStorage大于等于该值或者所有缓存都被干掉；

clearCaches

public static void clearCaches()

清空所有的缓存文件

setCacheUrlHashCallback

public static void setCacheUrlHashCallback(AliPlayerGlobalSettings.OnGetUrlHashCallback cb)

设置加载url的hash值回调。如果不设置，SDK使用md5算法。

setAdaptiveDecoderGetBackupURLCallback

public static void setAdaptiveDecoderGetBackupURLCallback(AliPlayerGlobalSettings.OnGetBackupUrlCallback cb)

设置取备用url的回调。

setNetworkCallback

public static void setNetworkCallback(AliPlayerGlobalSettings.OnNetworkCallback cb)

设置网络数据回调。用于监听http请求数据（目前只支持mp4）并支持修改

enableHttpDns

@Deprecated
public static void enableHttpDns(boolean enable)

已过时。

是否开启httpDNS。默认不开启。 开启后需要注意以下事项 1.该功能与增强型Httpdns互斥，若同时打开，后开启的功能会实际生效； 2.打开后，会使用标准httpdns进行请求，若失败会降级至local dns。

参数:

enable -

enableEnhancedHttpDns

public static void enableEnhancedHttpDns(boolean enable)

是否开启增强型httpDNS。默认不开启 开启后需要注意以下事项 1.该功能与Httpdns互斥，若同时打开，后开启的功能会实际生效； 2.需要申请license的高级httpdns功能，否则该功能不工作 3.需要通过接口com.aliyun.dns.DomainProcessor#addEnhancedHttpDnsDomain(String)添加cdn域名，否则会降级至local dns。 4.请确保该域名在alicdn平台添加并配置对应功能，确保可提供线上服务。配置方法请参考：https://www.alibabacloud.com/product/content-delivery-network

参数:

enable -

enableNetworkBalance

public static void enableNetworkBalance(boolean enable)

是否开启内建预加载网络平衡策略，播放过程中，自动控制预加载的运行时机。默认开启。

参数:

enable -

enableBufferToLocalCache

public static void enableBufferToLocalCache(boolean enable)

参数:

enable -

disableCrashUpload

public static void disableCrashUpload(boolean disable)

参数:

disable -