集成VR播放器--虚拟现实浪潮的一舟: UtoVR

骑猪看日落 2022-09-21 05:47 268阅读 0赞

最近圈内刮起一股VR与AR狂潮,虚拟现实与直播推流技术方兴未艾,正好在项目中也涉及到集成第三方播放器的支持,给大家介绍一款国内的,免费的,集成很方便的产品平台--UtoVR. 在实际使用过程中难免有些小bug,不过这也在所难免也可以接受,好在这个是全平台的,本文仅介绍其集成过程,有更多了解和交流的可以留言我.

UtoVR Player是一款全景视频播放器。它支持360度空间全景视频的播放。观看者通过与播放器的交互，可以体验到身临其境的视觉效果。UtoVR Player SDK可以帮助你在自己的应用中，快速实现全景视频的播放效果。集成VR播放器SDK，可以帮助你在自己的应用中，快速实现全景视频的播放效果。  
目前支持4种应用，包括iOS、Android、Web端Flash、Web端Html5。

功能：  
  
  
1，支持视频格式：h264编码的mp4等视频文件；  
2，支持播放普通全景视频（2：1）；  
3，支持2K高清、4K超高清（本地）的全景视频播放；  
4，支持点播（mp4、HLS）、直播（HLS格式）播放全景视频；  
5，支持手指的上、下、左、右的滑动，放大、缩小全景视频的操作；  
6，支持陀螺仪的上、下、左、右控制全景视频的操作；  
7，支持单屏/双屏（VR模式）的操作；  
8，支持全屏、非全屏的操作；  
9，支持视频的播放、暂停、以及时间进度条的控制；  
  
SDK及文档下载地址: http://www.utovr.com/sdk/download  
注：免费版本的SDK不支持直播功能，并且UI画面的左下角带有"@2016 UtoVR - SDK"的信息，具体免费版本和定制版本的功能区别请参见官网。  
  
  
包含内容：  
  
  
1，doc：文档，主要是SDK API接口说明，可以双击运行“UtoVRAPI文档.html”，然后双击UVMediaPlayer --> 详细说明。  
  
  
2，lib：SDK所需的文件，如果开发者重新建立工程或将UtoVR播放器集成到自己工程，请将该目录下所有文件拷贝到工程对应目录下。  
  
  
3，sample：UtoVRPlayerDemo,Demo程序，演示了如何使用UtoVR全景播放器SDK。开发环境Android Studio 1.5.1，如果Android Studio版本比较低需要更新一下插件。

# **集成过程:** #

开发环境准备：  
  
  
1，开发工具  
Android开发工具很多，在这我们推荐各位开发者使用Eclipse和Android Studio作为自己的开发工具。下面我们将分别针对Eclipse和Android Studio介绍一下UtoVR Player SDK的工程配置方法。  
  
  
Eclipse工程配置方法  
第一步：在工程里新建libs文件夹，将开发包里libs目录下的所有文件和目录拷贝到libs根目录下，拷贝完成后的工程目录如下图所示；  
libs  
│  utovr\_player\_1.0.1065.jar  
│    
├─arm64-v8a  
│      libjniUtoVR.so  
│        
├─armeabi  
│      libjniUtoVR.so  
│        
├─armeabi-v7a  
│      libjniUtoVR.so  
│        
├─mips  
│      libjniUtoVR.so  
│        
├─mips64  
│      libjniUtoVR.so  
│        
├─x86  
│      libjniUtoVR.so  
│        
└─x86\_64  
        libjniUtoVR.so  
  
  
第二步：在工程属性->Java Build Path->Libraries中选择“Add External JARs”，选定utovr\_player\_X.X.X.jar，确定后返回。  
第三步：将开发包里res目录下的所有文件和目录拷贝到res根目录下，拷贝完成后的工程目录如下图所示；  
res  
├─anim  
│      loading.xml  
│        
├─drawable-hdpi  
│      loading\_1.png  
│      loading\_10.png  
│      loading\_11.png  
│      loading\_12.png  
│      loading\_2.png  
│      loading\_3.png  
│      loading\_4.png  
│      loading\_5.png  
│      loading\_6.png  
│      loading\_7.png  
│      loading\_8.png  
│      loading\_9.png  
│        
├─drawable-xhdpi  
│      loading\_1.png  
│      loading\_10.png  
│      loading\_11.png  
│      loading\_12.png  
│      loading\_2.png  
│      loading\_3.png  
│      loading\_4.png  
│      loading\_5.png  
│      loading\_6.png  
│      loading\_7.png  
│      loading\_8.png  
│      loading\_9.png  
│        
└─values  
        ids.xml  
第四步：修改AndroidManifest.xml文件，在里面加入：  
    <uses-feature android:glEsVersion="0x00020000" android:required="true" />  
    <uses-permission android:name="android.permission.WRITE\_EXTERNAL\_STORAGE" />  
    <uses-permission android:name="android.permission.READ\_EXTERNAL\_STORAGE" />  
    <uses-permission android:name="android.permission.INTERNET" />  
    <uses-permission android:name="android.permission.WAKE\_LOCK" />  
    <uses-permission android:name="android.permission.ACCESS\_WIFI\_STATE" />  
    <uses-permission android:name="android.permission.READ\_PHONE\_STATE" />  
  
  
通过以上四步操作后，您就可以正常使用UtoVR Player SDK为您提供的全部功能了。  
  
  
  
  
Android Studio工程配置方法  
推荐用Android Studio 1.5.1版本及以上  
第一步：在工程app/libs目录下放入utovr\_player\_X.X.X.jar包以及so文件如下图所示。  
libs  
│  utovr\_player\_1.0.1065.jar  
│    
├─arm64-v8a  
│      libjniUtoVR.so  
│        
├─armeabi  
│      libjniUtoVR.so  
│        
├─armeabi-v7a  
│      libjniUtoVR.so  
│        
├─mips  
│      libjniUtoVR.so  
│        
├─mips64  
│      libjniUtoVR.so  
│        
├─x86  
│      libjniUtoVR.so  
│        
└─x86\_64  
        libjniUtoVR.so  
  
  
第二步：导入jar包。菜单栏选择File->Project Structor->Modules->Dependencies,点击+号，选择File dependency，选择jar包导入。  
第三步：将开发包里res目录下的所有文件和目录拷贝到res根目录下，拷贝完成后的工程目录如下图所示；  
res  
├─anim  
│      loading.xml  
│        
├─drawable-hdpi  
│      loading\_1.png  
│      loading\_10.png  
│      loading\_11.png  
│      loading\_12.png  
│      loading\_2.png  
│      loading\_3.png  
│      loading\_4.png  
│      loading\_5.png  
│      loading\_6.png  
│      loading\_7.png  
│      loading\_8.png  
│      loading\_9.png  
│        
├─drawable-xhdpi  
│      loading\_1.png  
│      loading\_10.png  
│      loading\_11.png  
│      loading\_12.png  
│      loading\_2.png  
│      loading\_3.png  
│      loading\_4.png  
│      loading\_5.png  
│      loading\_6.png  
│      loading\_7.png  
│      loading\_8.png  
│      loading\_9.png  
│        
└─values  
        ids.xml  
第四步：修改AndroidManifest.xml文件，在里面加入：  
    <uses-feature android:glEsVersion="0x00020000" android:required="true" />  
    <uses-permission android:name="android.permission.WRITE\_EXTERNAL\_STORAGE" />  
    <uses-permission android:name="android.permission.READ\_EXTERNAL\_STORAGE" />  
    <uses-permission android:name="android.permission.INTERNET" />  
    <uses-permission android:name="android.permission.WAKE\_LOCK" />  
    <uses-permission android:name="android.permission.ACCESS\_WIFI\_STATE" />  
    <uses-permission android:name="android.permission.READ\_PHONE\_STATE" />  
      
通过以上四步操作后，您就可以正常使用UtoVR Player SDK为您提供的全部功能了。  
  
  
  
  
2，应用混淆  
集成UtoVR Player SDK的应用，在打包混淆的时候，需要注意与UtoVR Player SDK相关的方法不可被混淆。混淆方法如下：  
  -dontwarn com.google.\*\*  
  -dontwarn android.media.\*\*  
  -keepattributes InnerClasses, Signature, \*Annotation\*  
  -keep class com.utovr.\*\* \{\*;\}  
  -keep class com.google.\*\* \{\*;\}  
  -keep class android.media.\*\* \{\*;\}  
  
  
  
  
3，运行环境  
运行环境需求：Android 4.1（API level 16）及其以上版本  
  
  
\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*  
  
  
反馈：  
  
  
官网：http://www.utovr.com  
技术支持：support@utovr.com  
bbs： http://bbs.utovr.com/forum.php?mod=forumdisplay&fid=49