# 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中使用。

注意

官方插件都是自注册的不需要调用这个方法。

上次更新: 4/13/2022, 2:39:50 PM