.. _2	如何启动视频播放器:

2	如何启动视频播放器
=========================================

2.1 设置 Action
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

在Android层初始化Intent，通过设置action "picovr.intent.action.player" 来启动内置视频播放器。

2.2 参数设置
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

以下是在Intent中要输入的参数。本地视频需要输入uri(path)和title，而视频直播资源则至少需要输入uri。

======================	==============   	=========================================================================================
参数                    类型   				                备注
======================  ==============		=========================================================================================
uri                     String				    播放地址（必传）
title                   String				    视频名称（必传）
videoType               String				    视频类型
playTime                Int				    播放起点
videoSource		String				视频来源。0:网络 1:本地 2:飞屏 3:直播 4:乐播
scenes                  Int				        改变背景。0代表pmax；1代表空白；2代表海滩影院。
position                Float				        相机的位置（仅在大屏模式下生效）
seekPlay                Boolean				        跳到最后播放的位置。传true重新播放，传false续播；true表示在屏幕关闭以及再次打开后，视频将从头开始播放。
loop                    Boolean				        是否循环播放列表视频。传true循环播放列表视频。
isControl                Boolean				        是否显示控制面板UI。传true显示UI。
play_list                String				        视频播放列表。列表格式应为JSON。
shouldPlayIndex          Int				        选择播放列表中的视频进行播放。
======================  ==============		=========================================================================================


play_list JSON 数据格式为

.. code-block:: c#

	[{\"index\":0,\"name\":\"test2D.mp4\",\"playMode\":0,\"url\":\"%2Fsdcard%2Ftest2D.mp4\"},{\"index\":1,\"name\":\"test.mp4\",\"playMode\":2,\"url\":\"%2Fsdcard%2Ftest.mp4\"}]

2.3 权限
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

在AndroidManifest.xml 文件中，需要添加以下权限：

.. code-block:: XML

	<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />

	<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

2.4 所支持的视频格式
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

下表为支持的视频类型以及类型参数：

==============================	==================================	=============
		视频类型													 参数
==============================	==================================	=============
_2D						2D			                    		0
_3D_LR						3D左右			                    		1
_360						全景 2D			                		2
_3D360_TB					全景 3D 上下                                   		3
_3D360_BT					全景 3D 下上		        		4
_3D360_LR					全景 3D 左右				5
_3D360_RL					全景 3D 右左				6
_3D_TB						3D 上下						                 7
_3D_BT						3D 下上						            8
_3D_RL						3D 右左						            9
_180						180°   2D							10
_3D180_TB					180° 3D  上下						    11
_3D180_BT					180° 3D  下上						12
_3D180_LR					180° 3D  左右						    13					
_3D180_RL					180° 3D  右左					    14
_2DFishEye					FishEye   2D						    15
_3DFishEye_TB					FishEye 3D  上下						16
_3DFishEye_BT					FishEye 3D  下上					17
_3DFishEye_LR					FishEye 3D  左右						18
_3DFishEye_RL					FishEye 3D  右左						19
_CubeMap					Youtube							        20
_CubeMap_LR					Youtube 3D 左右					21
==============================	==================================	=============

**注意：** 如果没有任何指定的视频类型，则默认为0（2D）。

2.5 示例代码
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 

aar文件下载地址： https://github.com/picoxr/launch-pico-player/blob/master/resource/launch-pico-player.aar 

在Unity项目中，如何调用aar文件中的函数，请参考示例代码。

示例代码：

.. code-block:: c#

	AndroidJavaObject context = new AndroidJavaClass("com.unity3d.player.UnityPlayer").GetStatic<AndroidJavaObject>("currentActivity");
	AndroidJavaObject videoPlayer = new AndroidJavaObject("com.picovr.picoplaymanager.PicovrLaunchPlayer");
	videoPlayer.Call<AndroidJavaObject>("uri", "/sdcard/test.mp4", false)
		   .Call<AndroidJavaObject>("playTime", 20)
		   .Call<AndroidJavaObject>("scenes", 2)
		   ...
		   .Call("launchVideoPlayer", context);