aliplayer_widget_lib library

AliPlayer Widget Library

A powerful and flexible vod component for Flutter applications. It integrates with flutter_aliplayer to provide high-quality video playback, seamless streaming, and a rich set of features for both live and on-demand video content. Whether you are building a video playback solution for education, entertainment, or any other application, it makes it easy to deliver an engaging video experience.

Classes

AliMediaInfo
Represents media metadata from Alibaba Cloud SDK. 阿里云 SDK 返回的媒体信息模型。
AliPlayerGlobalSettings
GlobalSetting 特定功能
AliPlayerView
AliPlayerView
AliPlayerWidget
一个用于播放视频的 Widget,支持自定义控制器和覆盖层。
AliPlayerWidgetController
播放器组件控制器,用于管理阿里云播放器的初始化、播放和销毁逻辑
AliPlayerWidgetData
播放器组件数据,用于存储播放器所需的视频数据
AliPlayerWidgetGlobalSetting
AliPlayer Widget Global Setting
AliPlayerWidgetState
播放器组件状态
AliTrackInfo
Represents a media track (audio, video, or subtitle) info. 媒体轨道(音视频或字幕)信息模型。
AlphaRenderMode
AlphaRenderMode
AVPConfig
AVPConfig设置
AVPFilterInfo
AVPMediaInfo
AVPThumbnailInfo
AVPTrackInfo
BasePlayerStrategy
策略基类,自动管理 ValueNotifier 监听的订阅与清理
BaseVideoSource
视频源基础抽象类 定义了视频源的基本结构和接口
BottomBarElements
底部栏元素 key 常量
CenterDisplayElements
中心显示元素 key 常量
ChapterInfo
章节信息
CustomSubtitleBuilder
自定义字幕构建器,允许开发者通过自定义函数完全控制字幕的渲染方式。
DefaultSlotFactory
内置插槽的默认构建器注册表。 Default builder registry for built-in slots.
DefaultSubtitleBuilder
默认字幕构建器,使用 SubtitleStyleConfig 中的样式渲染字幕文本。
DownloadCompletedState
下载完成状态
DownloadErrorState
下载异常状态
DownloadEvent
下载事件回调
DownloadingState
下载中状态
DownloadManager
视频下载管理器
DownloadState
EventChanneldef
FirstFrameStrategy
首帧耗时统计策略
FlutterAliplayer
FlutterAliPlayerFactory
FlutterAliPlayerGlobalSettings
FlutterAvpdef
FullScreenWidget
播放器全屏视图
FullScreenWidgetState
GlobalEnv
设置环境Env
InfoCode
infoCode
LogLevel
Log 日志级别
MirrorMode
*@brief Mirroring mode/
OnSourceExpired<T>
PixelNumber
PlayControlElements
播放控制手势元素 key 常量
PlayerAssetsScope
用于在 Widget 树中传递资源路径
PlayerI18n
播放器国际化管理类
PlayerI18nKeys
播放器国际化 Key 常量定义
PlayerIcons
播放器图标文件名常量
PlayerLocalizations
播放器本地化类
PlayerLocalizationsDelegate
播放器本地化代理
PlayerStrategy
播放器策略接口
PlayerStyles
播放器 UI 设计 Token
PlayerTranslations
播放器翻译接口
PlayerType
PlayState
播放器状态
PlayStateElements
播放状态元素 key 常量
PreloadConfig
预加载配置类 用于配置媒体预加载的相关参数
PrivacyUtil
隐私保护工具类
RotateMode
*@brief Rotate mode/
ScaleMode
SeekMode
SeekThumbnailElements
Seek 缩略图元素 key 常量
SettingMenuElements
设置菜单元素 key 常量
SlotBuildContext
插槽构建所需的依赖集合。 Dependencies required for building built-in slots.
SlotConfig
插槽显示配置
SlotConstants
插槽常量定义类。
SlotManager
插槽管理器
SlotType
插槽类型定义
StrategyManager
策略管理器,统一管理已注册策略的生命周期
StutterDetectStrategy
卡顿检测策略
StutterInfo
卡顿统计信息
Subtitle
单条字幕实体,包含轨道索引和字幕文本。
SubtitleBuilder
字幕构建器接口,定义字幕 Widget 的构建合约。
SubtitleConfig
字幕完整配置,包含样式、位置和动画设置。
Subtitles
字幕集合,管理多条字幕轨道。
SubtitleStyleConfig
字幕样式配置,控制字幕的文本样式和布局属性。
TopBarElements
顶部栏元素 key 常量
UnknownState
未知状态
UrlSource
URL预加载任务类 用于处理基于直接URL的视频源预加载
UrlVideoSource
URL 类型的视频源
VidAuth
VID+Auth视频源类 用于处理基于VID和PlayAuth的视频源
VidAuthVideoSource
VidAuth 类型的视频源
VideoSource
视频播放源基类
VideoSourceFactory
视频源工厂类
VidSourceConfig
VID源配置类 用于配置VID类型的视频源参数
VidSts
VID+STS视频源类 用于处理基于VID和STS凭证的视频源
VidStsVideoSource
VidSts 类型的视频源

Enums

AliPlayerAudioSesstionType
播放器音频设置选择
AliPlayerViewTypeForAndroid
Android 渲染 View 类型
AndroidViewType
Android 播放器视图类型
AVPIpResolveType
IP 解析类型
AVPOption
AVPPropertyKey
获取信息播放器的key
DocTypeForIOS
iOS 沙盒目录类型
EncryptionType
encryptionType
EncryptType
encryptType
MultiBitratesMode
默认配置,播放和预加载默认码率
PlayerScene
播放场景
PreloadScene
预加载场景
SceneType
播放场景类型
SourceType
视频资源类型
SupportFeatureType
是否支持的功能的类型
TrackType
TrackInfo 获取current Type
VideoSourceType
视频源类型枚举 定义了支持的视频源类型:URL、VID+Auth、VID+STS

Mixins

PlayerTranslationsMixin
翻译 Mixin,提供通用实现逻辑

Extensions

HiddenElementsExt on Set<String>?
隐藏元素集合的扩展方法
PlayerLocalizationsExtension on BuildContext
Localizations 扩展,方便从 BuildContext 获取翻译

Typedefs

AliPlayerViewCreatedCallback = void Function(int viewId)
OnAuthSourceExpiredCallBack = Future<VidAuth?> Function(VidAuth? expiredVidAuth)
OnBackPressedCallback = bool? Function()
返回键回调类型定义
OnCompletion = void Function(String playerId)
OnError = void Function(int errorCode, String? errorExtra, String? errorMsg, String playerId)
OnEventReportParams = void Function(Map params, String playerId)
OnGlobalInitCallback = void Function()
全局初始化自定义配置回调
OnInfo = void Function(int? infoCode, int? extraValue, String? extraMsg, String playerId)
OnLoadingBegin = void Function(String playerId)
OnLoadingEnd = void Function(String playerId)
OnLoadingProgress = void Function(int percent, double? netSpeed, String playerId)
OnLogInfoCallback = void Function(int level, String strlog)
OnPipStatusChanged = void Function(bool playing, String playerId)
OnPlayerConfigCallback = FutureOr<void> Function(FlutterAliplayer player)
实例级别播放器自定义配置回调
OnPrepared = void Function(String playerId)
OnRenderingStart = void Function(String playerId)
OnSeekComplete = void Function(String playerId)
OnSeekLiveCompletion = void Function(int level, String strlog)
OnSeiData = void Function(int type, Uint8List uuid, Uint8List data, String playerId)
OnSnapShot = void Function(String path, String playerId)
OnStateChanged = void Function(int level, String strlog)
OnStreamSwitchedFail = void Function(String url, int errorCode, String errorMsg)
OnStreamSwitchedSuccess = void Function(String playerId)
OnSubtitleExtAdded = void Function(int trackIndex, String url, String playerId)
OnSubtitleHeader = void Function(int trackIndex, String url, String playerId)
OnSubtitleHide = void Function(int trackIndex, int subtitleID, String playerId)
OnSubtitleShow = void Function(int trackIndex, int subtitleID, String subtitle, String playerId)
OnSubTrackReady = void Function(String playerId)
OnThumbnailGetFail = void Function(String playerId)
OnThumbnailGetSuccess = void Function(Uint8List bitmap, Int64List range, String playerId)
OnThumbnailPreparedFail = void Function(String playerId)
OnThumbnailPreparedSuccess = void Function(String playerId)
OnTimeShiftUpdater = void Function(int currentTime, int shiftStartTime, int shiftEndTime, String playerId)
OnTrackChanged = void Function(dynamic value, String playerId)
OnTrackReady = void Function(String playerId)
OnURLSourceExpiredCallBack = Future<String?> Function(String? expiredUrl)
OnVideoRendered = void Function(int? timeMs, int? pts, String playerId)
OnVideoSizeChanged = void Function(int width, int height, int? rotation, String playerId)
OnWillStartPip = void Function(bool playing, String playerId)
OnWillStopPip = void Function(bool playing, String playerId)
SlotBuilder = Widget Function(double width, double height)
插槽内容构建器,根据宽高创建插槽内容 Widget。
SlotWidgetBuilder = Widget Function(BuildContext context)
插槽构建器类型定义