Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/myflashlab/GoogleVR-ANE
Google Virtual Reality SDK available to Adobe Air developers
https://github.com/myflashlab/GoogleVR-ANE
Last synced: about 2 months ago
JSON representation
Google Virtual Reality SDK available to Adobe Air developers
- Host: GitHub
- URL: https://github.com/myflashlab/GoogleVR-ANE
- Owner: myflashlab
- Archived: true
- Created: 2016-06-22T06:48:10.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2019-08-03T18:24:19.000Z (over 5 years ago)
- Last Synced: 2024-08-03T05:03:14.496Z (5 months ago)
- Language: ActionScript
- Size: 271 MB
- Stars: 16
- Watchers: 6
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: ChangeLog.md
Awesome Lists containing this project
- awesome-actionscript-sorted - GoogleVR-ANE - Google Virtual Reality SDK available to AIR developers (Native Extension / Hardware ANE)
README
# Google VR ANE for Android+iOS
Google Virtual Reality SDK works on Android and iOS so why shouldn't it work on Air? This cool ANE will let you use 360 images and videos in your own AIR application.
*Notice: Supporting Virtual 3D world is not in our to-do list. At least not for the moment, because rendering the 3D world in Virtual Reality is happening in OpenGL inside the native environment and ANEs cannot provide this feature to AS3*
**Main Features:**
* 360 image preview based on device orientation
* 360 video preview based on device orientation
* supporting Google VR Mode for [cardboard](https://vr.google.com/cardboard/index.html)
* 100% identical AS3 API for Android and iOS
[find the latest **asdoc** for this ANE here.](http://myflashlab.github.io/asdoc/index.html?com/myflashlab/air/extensions/googleVR/package-detail.html&com/myflashlab/air/extensions/googleVR/class-list.html)
**NOTICE 2**: On older Android devices you may see your AIR content all black when you return from the 360 video view. This is an old bug in AIR and we hope Adobe would find the reason and hopefully fix it someday. In the meanwhile, [read this to fix the problem](http://forum.starling-framework.org/topic/ane-fix-for-blackblank-screen-bug-when-returning-to-air-android-apps)
# AIR Usage General listeners
For the complete AS3 code usage, see the [demo project here](https://github.com/myflashlab/GoogleVR-ANE/blob/master/AIR/src/Demo.as).
```actionscript
import com.myflashlab.air.extensions.googleVR.*;
VR.init();
// add general VR listeners
VR.api.addEventListener(VREvents.VR_CLOSED, onVRClosed);
VR.api.addEventListener(VREvents.DID_TAP, onVRTapped);
VR.api.addEventListener(VREvents.DISPLAY_MODE_CHANGED, onVRModeChanged);
function onVRClosed(e:VREvents):void
{
trace("vr window closed!");
}
function onVRTapped(e:VREvents):void
{
trace("vr window tapped!");
// get the current head position of the VR view
trace(VR.api.headRotation);
// you can change display mode from AS3 also.
//VR.api.displayMode = DisplayMode.FULLSCREEN_STEREO;
// when playing 360 videos, you may toggle pause/resume when the VR screen is tapped
if (VR.api.videoView.isPaused)
{
VR.api.videoView.resume();
}
else
{
VR.api.videoView.pause();
}
}
function onVRModeChanged(e:VREvents):void
{
switch (e.displaymode)
{
case DisplayMode.EMBEDDED:
trace("vr mode changed: EMBEDDED");
break;
case DisplayMode.FULLSCREEN_MONO:
trace("vr mode changed: FULLSCREEN_MONO");
break;
case DisplayMode.FULLSCREEN_STEREO:
trace("vr mode changed: FULLSCREEN_STEREO");
break;
default:
}
}
```
# AIR Usage 360 Image
For the complete AS3 code usage, see the [demo project here](https://github.com/myflashlab/GoogleVR-ANE/blob/master/AIR/src/Demo.as).
```actionscript
// configure the 360 image object you want to launch
var vrSetting:VRConfigImg = new VRConfigImg();
vrSetting.btnExit = File.applicationDirectory.resolvePath("exit.png");
vrSetting.image360 = File.applicationDirectory.resolvePath("360Img.jpg");
vrSetting.imageType = VRConfig.TYPE_STEREO_OVER_UNDER;
vrSetting.stereoModeButtonEnabled = true;
vrSetting.infoButtonEnabled = false;
vrSetting.touchTrackingEnabled = true;
// and finally attach the Image Config instance to the VR ANE
VR.api.imageView.addEventListener(VREvents.LOAD_FAILED, onLoadFailed);
VR.api.imageView.addEventListener(VREvents.LOAD_SUCCESS, onLoadSuccess);
VR.api.imageView.attach(vrSetting);
function onLoadFailed(e:VREvents):void
{
VR.api.imageView.removeEventListener(VREvents.LOAD_FAILED, onLoadFailed);
VR.api.imageView.removeEventListener(VREvents.LOAD_SUCCESS, onLoadSuccess);
trace("onLoadFailed: " + e.msg);
}
function onLoadSuccess(e:VREvents):void
{
VR.api.imageView.removeEventListener(VREvents.LOAD_FAILED, onLoadFailed);
VR.api.imageView.removeEventListener(VREvents.LOAD_SUCCESS, onLoadSuccess);
trace("onLoadSuccess");
}
```
# AIR Usage 360 Video
For the complete AS3 code usage, see the [demo project here](https://github.com/myflashlab/GoogleVR-ANE/blob/master/AIR/src/Demo.as).
```actionscript
// configure the 360 video object you want to launch
var vrSetting:VRConfigVid = new VRConfigVid();
vrSetting.btnExit = File.applicationDirectory.resolvePath("exit.png");
vrSetting.video360 = File.applicationDirectory.resolvePath("360Vid.mp4");
//vrSetting.video360URL = "http://192.168.0.11/project/products/MyFlashLab_ANEs/googleVR/Vx.x.x/FD/bin/360Vid.mp4";
vrSetting.videoType = VRConfig.TYPE_STEREO_OVER_UNDER;
vrSetting.stereoModeButtonEnabled = true;
vrSetting.infoButtonEnabled = false;
vrSetting.touchTrackingEnabled = true;
vrSetting.fullscreenButtonEnabled = true;
VR.api.videoView.addEventListener(VREvents.LOAD_FAILED, onVideoLoadFailed);
VR.api.videoView.addEventListener(VREvents.LOAD_SUCCESS, onVideoLoadSuccess);
VR.api.videoView.addEventListener(VREvents.PAUSED, onVideoPaused);
VR.api.videoView.addEventListener(VREvents.REACHED_END, onVideoReachedEnd);
VR.api.videoView.addEventListener(VREvents.RESUMED, onVideoResumed);
VR.api.videoView.addEventListener(VREvents.STOPPED, onVideoStopped);
VR.api.videoView.addEventListener(VREvents.POS_UPDATED, onVideoPositionUpdated);
VR.api.videoView.attach(vrSetting);
function onVideoLoadFailed(e:VREvents):void
{
VR.api.videoView.removeEventListener(VREvents.LOAD_FAILED, onVideoLoadFailed);
VR.api.videoView.removeEventListener(VREvents.LOAD_SUCCESS, onVideoLoadSuccess);
trace("onVideoLoadFailed: " + e.msg);
}
function onVideoLoadSuccess(e:VREvents):void
{
VR.api.videoView.removeEventListener(VREvents.LOAD_FAILED, onVideoLoadFailed);
VR.api.videoView.removeEventListener(VREvents.LOAD_SUCCESS, onVideoLoadSuccess);
trace("onVideoLoadSuccess, video duration = " + e.duration);
}
function onVideoPaused(e:VREvents):void
{
trace("onVideoPaused");
}
function onVideoResumed(e:VREvents):void
{
trace("onVideoResumed");
}
function onVideoStopped(e:VREvents):void
{
trace("onVideoStopped");
}
function onVideoReachedEnd(e:VREvents):void
{
VR.api.videoView.seekTo(0);
VR.api.videoView.resume();
trace("onVideoReachedEnd");
}
function onVideoPositionUpdated(e:VREvents):void
{
trace("position updated... " + e.position + " / " + e.duration);
}
```
# AIR .xml manifest
```xml
MinimumOSVersion
10.0
NSAppTransportSecurity
NSAllowsArbitraryLoads
NSCameraUsageDescription
Camera usage description
com.myflashlab.air.extensions.dependency.gvr.common
com.myflashlab.air.extensions.dependency.gvr.commonwidget
com.myflashlab.air.extensions.dependency.gvr.panowidget
com.myflashlab.air.extensions.dependency.gvr.videowidget
com.myflashlab.air.extensions.dependency.androidSupport.core
com.myflashlab.air.extensions.dependency.androidSupport.v4
com.myflashlab.air.extensions.dependency.overrideAir
com.myflashlab.air.extensions.googleVR
com.myflashlab.air.extensions.permissionCheck
-->
```
# Requirements
1. Android API 19+
2. iOS SDK 10.0+
3. AIR SDK 30+
4. On the iOS side, you need to make sure you have included the resources at the root of you package.
* **CardboardSDK.bundle**
* **GoogleKitCore.bundle**
* **GoogleKitDialogs.bundle**
* **GoogleKitHUD.bundle**
* **MaterialRobotoFontLoader.bundle**
5. Moreover, on the iOS side, you will need **GoogleToolboxForMac.framework** and **GTMSessionFetcher.framework** available in your *AIR_SDK/lib/aot/stub* folder. Download them from [this package - Firebase SDK V5.20.2](https://dl.google.com/firebase/sdk/ios/5_20_2/Firebase-5.20.2.zip).
# Permissions
Below are the list of Permissions this ANE might require. Check out the demo project available at this repository to see how we have used the [PermissionCheck ANE](http://www.myflashlabs.com/product/native-access-permission-check-settings-menu-air-native-extension/) to ask for the permissions.
Necessary | Optional
--------------------------- | ---------------------------
. | [SOURCE_STORAGE](https://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/nativePermissions/PermissionCheck.html#SOURCE_STORAGE)
. | [SOURCE_CAMERA](https://myflashlab.github.io/asdoc/com/myflashlab/air/extensions/nativePermissions/PermissionCheck.html#SOURCE_CAMERA)
# Commercial Version
https://www.myflashlabs.com/product/virtual-reality-air-native-extension/
[](https://www.myflashlabs.com/product/virtual-reality-air-native-extension/)
# Tutorials
[How to embed ANEs into **FlashBuilder**, **FlashCC** and **FlashDevelop**](https://www.youtube.com/watch?v=Oubsb_3F3ec&list=PL_mmSjScdnxnSDTMYb1iDX4LemhIJrt1O)
# Premium Support #
[](https://www.myflashlabs.com/product/myflashlabs-support/)
If you are an [active MyFlashLabs club member](https://www.myflashlabs.com/product/myflashlabs-club-membership/), you will have access to our private and secure support ticket system for all our ANEs. Even if you are not a member, you can still receive premium help if you purchase the [premium support package](https://www.myflashlabs.com/product/myflashlabs-support/).