# play
play(config?: PlayInfoConfig, extra?: {
startTime?: number;
}): void;
// example 使用地址直接播放
player.play({ url: '//commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4' });
// example 使用vid播放
player.play({ vid: 'k0034doxh3c' });
播放指定的url/vid/cnlid。根据传入的config
类型决定播放方式:如果传入了vid/cnlid则会优先使用vid/cnlid播放,否则使用url播放。
extra
参数可以指定起播时间点(单位:秒)和强制指定使用的播放内核(非原生内核需要先手动加载)。
不传入任何参数的时候调用video的play方法
# 参数
参数名 | 类型 | 含义 | 必填 | 默认值 |
---|---|---|---|---|
config | playConfig | { vid: string } | { cnlid: string; livepid: string } | 播放配置(需要播放的url/vid/cnlid, 备用地址/清晰度列表等) | false | undefined |
extra | { startTime: number, levels?: ILevelConfig } | 起播时间(单位:秒) | false | undefined |
# load
load(config: playInfoConfig, extra?: {
startTime?: number;
}): void;
使用方法和play
相同。区别是load
方法在加载完成后不会自动开始播放。
注意
仅支持点播模式
# pause
pause(): void;
暂停
# seek
seek(time: number): void;
跳转到指定的视频时间点。
注意
仅支持点播模式
# stop
stop(): void;
停止播放。
# setLevel
setLevel(defn: string): void;
切换清晰度。 如果当前是使用vid/cnlid进行播放的,会先向腾讯视频播放后天换取新的清晰度播放地址;如果是url播放则需要在play/load时传入levels
信息。
参数名 | 类型 | 含义 | 必填 | 默认值 |
---|---|---|---|---|
defn | string | 清晰度的名称,vid/cnlid播放需要参照腾讯视频请求清晰度参数的要求;url播放需要和事先传入的levels 中的value 字段相同 | true | - |
# on
on(eventName: string, handler: (...args: any[]) => void, priority?: number): this;
监听指定事件。
除SuperPlayer自有事件外,开发者可以在Superplayer
上监听到所有内核抛出的事件和部分对播放流程有影响的插件所抛出的事件(比如getinfoOver
事件)。
注意
在SuperPlayer上监听的事件,目标(target)和回调中的this指向为SuperPlayer。
# destroy
destroy(): void;
销毁
# getPlugin
getPlugin<T extends keyof IPluginInstances>(name: T): IPluginInstances[T];
获取指定的插件实例。
# getCommonKv
getCommonKv(key: string): any;
获取数据中心中指定字段的数据。
# (static) registerPlugin
static registerPlugin(name: string, plugin: PluginType): PluginType;
注册一个新的插件,只有注册过的插件才可以添加到配置项的plugins
中使用。
注意
官方插件都是自注册的不需要调用这个方法。