相关文章推荐
配置skinLayout属性

配置skinLayout属性

更新时间:

如果您需要自定义Web播放器SDK的播放按钮、Loading动画和Controlbar UI这三个组件是否显示以及显示的位置,您可以通过skinLayout属性配置。本文为您介绍如何配置skinLayout属性。

skinLayout属性

Aliplayer可以通过skinLayout属性定制以下三个组件是否显示与显示的位置。

  • 播放按钮

  • Loading动画

  • Controlbar的UI

您可以通过配置播放器的CSS文件:aliplayer-min.css,修改skinLayout属性。配置方式,请参见 设置播放器皮肤

skinLayout设置规则

  • skinLayout属性未设置,则默认显示全部。

  • skinLayout设置为空集合([])或false时, 则全部隐藏。

    说明

    skinLayout设置为空集合([])或false隐藏播放器自带皮肤后,播放器报错界面也将不会显示,您将无法感知到播放异常等报错,此时,请务必监听 error 事件对报错进行适当的处理,错误码请参见 错误码

  • 如果是直播Controlbar的children属性,则只能设置为liveDisplay、fullScreenButton、subtitle、setting、volume和snapshot这几种UI组件。

使用skinLayoutIgnore隐藏UI组件

如果您希望在默认配置基础上隐藏部分UI组件,可以通过 skinLayoutIgnore 属性更简单地实现,配置示例如下:

skinLayoutIgnore: [
  'bigPlayButton', // 隐藏大播放按钮
  'controlBar.fullScreenButton' // 隐藏控制条上的全屏按钮(通过点运算符进行子组件选择)
]

可定义属性

align属性,组件相对于父级组件的对齐方式,可选项如下所示:

  • 'cc' ,相对于父组件绝对居中。

  • 'tl' ,相对于父组件左上对齐,受同级组件的占位影响,以组件的相对位置左上角作为偏移原点,可类比于css中的 float: left

  • 'tr' ,相对于父组件右上对齐,受同级组件的占位影响,以组件的相对位置右上角作为偏移原点,可类比于CSS中的 float: right

  • 'tlabs' ,相对于父组件左上绝对对齐,不受同级组件的占位影响,以父组件左上角作为偏移原点。

  • 'trabs' ,相对于父组件右上绝对对齐,不受同级组件的占位影响,以父组件右上角作为偏移原点。

  • 'blabs' ,相对于父组件左下绝对对齐,不受同级组件的占位影响,以父组件左下角作为偏移原点。

  • 'brabs' ,相对于父组件右下绝对对齐,不受同级组件的占位影响,以父组件右下角作为偏移原点。

x,y属性,组件相对于父级组件的位置,说明如下所示:

  • x,{Number},水平方向偏移量,偏移原点参考 align 的说明, cc 时无效。

  • y,{Number},垂直方向偏移量,偏移原点参考 align 的说明, cc 时无效。

点播默认配置

点播组件参数说明

组件参数

参数说明

bigPlayButton

大播放按钮。

H5Loading

视频缓冲时出现的加载动画。

errorDisplay

错误提示,当视频播放出错时的提示信息。

infoDisplay

信息提示,当切换字幕、倍速等设置时,播放器展示的提示信息。

tooltip

按钮提示,播放器控制栏上的控件提示信息。例如当光标移到音量按钮或播放按钮上时,会显示 音量 播放 的提示文字。

thumbnail

进度条缩略图。

controlBar

控制栏。

progress

播放进度条。

playButton

控制栏处的播放按钮。

timeDisplay

显示播放时间。

fullScreenButton

全屏按钮。

subtitle

字幕。

setting

设置。

volume

音量。

点播H5默认配置

skinLayout:[
   {name: "bigPlayButton", align: "blabs", x: 30, y: 80},
      name: "H5Loading", align: "cc"
    {name: "errorDisplay", align: "tlabs", x: 0, y: 0},
    {name: "infoDisplay"},
    {name:"tooltip", align:"blabs",x: 0, y: 56},
    {name: "thumbnail"},
      name: "controlBar", align: "blabs", x: 0, y: 0,
      children: [
        {name: "progress", align: "blabs", x: 0, y: 44},
        {name: "playButton", align: "tl", x: 15, y: 12},
        {name: "timeDisplay", align: "tl", x: 10, y: 7},
        {name: "fullScreenButton", align: "tr", x: 10, y: 12},
        {name:"subtitle", align:"tr",x:15, y:12},
        {name:"setting", align:"tr",x:15, y:12},
        {name: "volume", align: "tr", x: 5, y: 10}
  ]

点播Flash默认配置

skinLayout:[
    {name:"bigPlayButton", align:"blabs", x:30, y:80},
      name:"controlBar", align:"blabs", x:0, y:0,
      children: [
        {name:"progress", align:"tlabs", x: 0, y:0},
        {name:"playButton", align:"tl", x:15, y:26},
        {name:"nextButton", align:"tl", x:10, y:26},
        {name:"timeDisplay", align:"tl", x:10, y:24},
        {name:"fullScreenButton", align:"tr", x:10, y:25},
        {name:"streamButton", align:"tr", x:10, y:23},
        {name:"volume", align:"tr", x:10, y:25}
      name:"fullControlBar", align:"tlabs", x:0, y:0,
      children: [
        {name:"fullTitle", align:"tl", x:25, y:6},
        {name:"fullNormalScreenButton", align:"tr", x:24, y:13},
        {name:"fullTimeDisplay", align:"tr", x:10, y:12},
        {name:"fullZoom", align:"cc"}
]

配置效果图 点播默认配置

直播默认配置

直播组件参数说明

组件参数

参数说明

bigPlayButton

大播放按钮。

errorDisplay

错误提示,当视频播放出错时的提示信息。

infoDisplay

信息提示,当切换字幕、倍速等设置时,播放器展示的文字提示信息。

liveDisplay

直播播放时画面上显示 LIVE 字样。

controlBar

控制栏。

fullScreenButton

全屏按钮。

subtitle

字幕。

setting

设置。

volume

音量。

直播H5模式默认配置

skinLayout: [
    {name: "bigPlayButton", align: "blabs", x: 30, y: 80},
    {name: "errorDisplay", align: "tlabs", x: 0, y: 0},
    {name: "infoDisplay", align: "cc"},
      name: "controlBar", align: "blabs", x: 0, y: 0,
      children: [
          {name:"liveDisplay", align:"tlabs", x: 15, y:6},
          {name:"fullScreenButton", align:"tr", x:10, y: 10},
          {name:"subtitle", align:"tr",x:15, y:12},
          {name:"setting", align:"tr",x:15, y:12},
          {name:"volume", align:"tr", x:5, y:10}
  ]

直播Flash模式默认配置

skinLayout: [
    {name: "bigPlayButton", align: "blabs", x: 30, y: 80},
    {name: "errorDisplay", align: "tlabs", x: 0, y: 0},
    {name: "infoDisplay", align: "cc"},
      name: "controlBar", align: "blabs", x: 0, y: 0,
      children: [
          {name:"liveDisplay", align:"tlabs", x: 15, y:25},
          {name:"fullScreenButton", align:"tr",  x:10, y:25},
          {name:"volume", align:"tr",  x:10, y:25}
  ]

配置效果图 直播默认配置

 
推荐文章