media.playVideo()

类型 函数
库 media.*
返回值 无
修订版 2024.3703 版
关键字 多媒体、视频、回放、远程视频
另请参阅 native.newVideo()

概述

在设备特定的弹出式媒体播放器中播放指定路径（本地和远程）的视频。

视频播放期间，媒体播放器界面将接管。如果 showControls 函数参数为 true，则用户可以调整回放（开始、停止、搜索等）。此外，你可以指定一个侦听器，在视频结束后得到通知。请注意，此函数是异步的，因此将执行其后的任何代码。之后，应用程序代码将继续在 iOS 设备上运行，但在 Android 设备上，应用程序将挂起，直到视频播放完成。

受支持的视频格式取决于平台和版本。iOS 视频播放器支持回放文件名扩展名为 .mov、.mp4、.m4v 和 .3gp，并使用以下压缩标准

问题

通用

Windows 不支持此 API。

Android

如果视频路径是一个 URL，则必须将 INTERNET 权限添加到 build.settings 文件中才能播放视频。

settings =
{
   android =
   {
      usesPermissions =
      {
         "android.permission.INTERNET",
      },
   },
}

语法

media.playVideo( path [, baseSource ], showControls, listener )
path (必需)

字符串. 视频的本地文件名或远程 URL。

baseSource (可选)

常量. 控制如何解释本地文件路径的可选参数。它可以是系统定义的目录常量之一，也可以是 media.RemoteSource（用于访问远程服务器上的视频）。

showControls (必需)

布尔值. 如果为 true，则用户可以调整回放（开始、停止、搜索等）。

listener (可选)

侦听器. 侦听器会在视频结束后发出通知。侦听器可以是函数侦听器，也可以是表侦听器。如果是表，则必须有完成方法。分发到侦听器的事件将是完成事件。

示例

local onComplete = function( event )
   print( "video session ended" )
end
media.playVideo( "movie.m4v", true, onComplete )