目录

视频<Video>

功能概述

视频播放控件，将一段视频加入到视图中，能够设置播放、循环播放、声音控制等功能；支持AVI，MP4，MOV等多种格式的本地视频的播放。

XML规范

<Video name="" x="" y="" w="" h="" living="" src="" defaultBitmap="" sound="" scaleType="" play="" looping="" visibility=""/>

参数说明

参 数

类 型

选 项

注 释

name

字符串

必填

视频命名，可用于videoCommand的定位Video对象，以控制视频的播放、换源和音量等。

x

数值

选填

视频左上角x位置，支持数字表达式，默认值为0。

y

数值

选填

视频左上角y位置，支持数字表达式，默认值为0。

w(width)

数值

选填

视频显示的宽，单位像素，默认为屏幕大小。

h(height)

数值

选填

视频显示的高，单位像素，默认为屏幕大小。

play

字符串

选填

是否加载之后自动开始播放，true/false，默认值为true。

looping

字符串

选填

视频是否循环播放，true/false，默认值为false不循环播放。

sound

数值

选填

视频播放声音控制，值为0~1之间的值，值越大声音越大。

living

字符串

选填

路径是否为URI路径而非本地路径，true/false。living为true则src需为uri路径，默认false，默认为本地路径。

src

字符串

必填

视频的文件路径，可带文件夹路径，例如aa/exmple.mp4，js.mp4等。

视频支持用户自定义，自定义路径必须为sd卡下路径，须以“../../../../../sdcard”开头，例如“../../../../../sdcard/Pictures/123.mp4”，后续路径可自定义。视频格式支持mp4/avi/mov。视频文件须小于25M。

scaleType

字符串

选填

支持fill、fit_width、center_crop三种模式，默认为fill模式。

  • fill 表示填充满控件的宽高，若视频比例与控件不匹配会导致视频拉伸。
  • fit_width 表示宽匹配功能，视频等比缩放到控件的宽，若视频宽高比大于控件，则填充不满屏幕，若视频宽高比小于控件，则会有部分视频裁剪。
  • center_crop 表示视频等比缩放并居中充满整个控件的宽高，多余部分裁剪。
    说明：

    使用center_crop模式时，建议搭配image来设置视频第一帧（参照应用示例的示例2），不建议搭配defaultbitmap设置第一帧（效果不太协调）。

visibility

数值

选填

视频组件的可见性，支持true/false和1/0来分别调整视频的可见或者不可见。

isMusic

字符串

选填

是否支持主动获取三方音乐app的播放与暂停，true/false，默认值为false。isMusic="true"时，需设置turn、defaultBitmap和defaultBitmapMusic。

turn

数值

选填

主动获取三方音乐app时，会提供一段视频素材（注意：视频素材需要是无音轨的视频）。假设视频共15秒，前9秒是播放音乐暂停时的视频，9-15秒是播放音乐播放时的视频，那么9秒即为turn的值，单位是秒。

defaultBitmapMusic

字符串

选填

播放音乐时，视频未加载时或者停止时默认显示的图片。图片推荐为用于音乐播放状态的视频首帧图片。假设视频共15秒，前9秒是音乐暂停时播放的视频，9-15秒是音乐播放时播放的视频，则图片为视频第9秒的首帧图片。

defaultBitmap

字符串

选填

选填，默认图片，即视频未加载时或者停止时默认显示的图片。普通手机/折叠屏手机折叠态/平板竖屏态时使用。

图片需要和普通手机/折叠屏手机折叠态/平板竖屏态原本的视频保持一致的宽高，推荐使用视频首帧图片。因为视频加载需要时间，先显示一张首帧图，让视频显示有个平滑的过渡效果。

defaultBigBitmap

字符串

必填

选填，默认图片，即视频未加载时或者停止时默认显示的图片。折叠屏手机展开态/平板横屏态时使用。

图片需要和折叠屏手机展开态/平板横屏态原本的视频保持一致的宽高，推荐使用视频首帧图片。因为视频加载需要时间，先显示一张首帧图，让视频显示有个平滑的过渡效果。

isBackground

字符串

选填

允许设置为"true"或"false"，默认为false。设置为true表示该视频作为背景使用，必须与scaleType="center_crop"配合使用。

应用示例

示例一：插入一段视频，视频左上角坐标是x=0，y=0，宽高为屏幕的宽高，采用的模式是fit_width，那么最终显示的宽度为屏幕宽度，显示的高度为原视频高宽比例乘以屏幕宽度。视频的源是目录下的js.mp4文件，并且在视频未加载的时候会展示bg.jpg这张图片。视频加载之后会自动播放，并且没有声音，视频设置为循环播放。

<Video name="js" src="js.mp4" defaultBitmap="bg.jpg" play="true" sound="0" looping="true" scaleType="fit_width"/>

示例二：插入一段视频使其播放时适配屏幕为center_crop模式。

<!-- 解决视频加载中出现黑屏问题，配置image标签，first.png为视频第一帧 -->
     <Image  scaleType="center_crop" isBackground="true" src="first.png" />
<!-- 有声视频需要增加参数 sound="1" 无声为 sound="0" -->
     <Video name="js"  src="video.mp4" play="true" sound="1" looping="true" scaleType="center_crop" isBackground="true"/>