Vuforia Sample Release Notes

Samples 6.5.25 ( patch )

All

  • Cloud Reco and Books databases updated to meter unit scale

Unity

  • Video playback now stops when the target is not in view
  • Best Practices, Advanced Topics and Eyewear samples include Mars assets
  • Fix AR to VR transition on AR/VR sample 

Android

  • Configuring Gradle script of sample projects to not compress target databases - compression will prolong database load times
  • Set flag in sample projects Gradle script to disable compression for datasets avoiding long datasets loading time
  • Updated samples to Gradle 2.3.3 

iOS

  • N/A

Samples 6.5

Unity

  • Added new Mars themed content for Core Samples
  • Introduced new Mars themed targets
  • Updated UIs for Core Samples
  • Image Targets scene now shows use of video playback

Android

  • Samples updated to support Tango devices

iOS

  • Fixed UI threading to update on correct thread

Samples 6.2.11

iOS

  • Fixed  issue causing Virtual buttons to not work after being disabled and re-enabled
  • Fixed issue causing scan line not to render in the Cloud Reco sample

Samples 6.2.6

Unity

  • UI fixes for Core Samples App
  • Added support for Video playback with Open GL 3 
  • HoloLens sample error message for Vuforia errors
  • Script added to samples to render at 60 fps when possible

Android

  • Books rendering video background upside down when rotated 180 degrees 

UWP

  • Added video background rendering with rendering primitives for VuMark sample

Samples 6.1.17

Unity Sample

  • The Digital Eyewear sample has been updated to include the HoloLens sample


Samples 6.0.120

Unity Sample

  • The Unity Core Samples have been refactored into a single project

Android

  • All samples updated to use the Render Primitives API for video background rendering 
  • drawVideoBackground() method has been deprecated - apps using this method will need to migrate to the new Render Primitives API

iOS

  • All samples updated to use the Render Primitives API for video background rendering 
  • drawVideoBackground() method has been deprecated - apps using this method will need to migrate to the new Render Primitives API


Samples 6.0.117

Unity Samples

  • The samples have been updated to use libpng version 1.6.25

Unity Samples 6.0.114

Bug-fixes / new features

  • Introducing new Find The Penguin sample in Best Practices that shows multiple techniques for positioning virtual content in real-world settings

Known Issues

  • Find The Penguin Best Practices sample is not supported on the Nexus 5X

All Samples 6.0.112

Bug-fixes / new features

  • Introducing UWP build support for Unity and Visual Studio 2015 using the new Vuforia UWP SDK

Unity Samples

  • Added VuMark sample
  • Added HoloLens ImageTarget sample for the Vuforia Early Access Program
  • UWP sample builds supported

UWP

  • Introducing ImageTargets and VuMark samples using the Render Primitives API

Android

  • Added VuMark sample
  • Refactored ImageTargets sample to use Render Primitives API

iOS

  • Added VuMark Sample
  • Refactored ImageTargets sample to use Render Primitives API

Unity Samples 5.5.9

Bug-fixes / new features

All Unity Samples

  • Added support for Unity 5.4
  • Introduced use of Unity SceneManager API (available in Unity 5.3 and newer)
  • Updated sample scenes and camera clipping planes to use meter units (previously using millimeters)
  • Revised sample UI implementation using the new Unity UI system introduced with Unity 4.6 and newer (http://docs.unity3d.com/Manual/UISystem.html )   
  • Dramatically simplified and reduced UI-related sample script code
  • Removed some obsolete UNITY_X_Y platform checks in sample scripts
  • Update PDF files for print to use PTC Inc. logo and copyright notice
  • Updated About Page text to use PTC Inc. copyright notice

AR-VR

  • Added Device Tracker capabilities to track device orientation without using 3rd party SDK
  • Added dual operational mode for mono (mobile/handheld) and stereo viewers
  • Added built-in support for Cardboard stereo viewers and head orientation tracking, without requiring Cardboard SDK integration (although SDK integration is still supported)
  • Updated sample code to use the new MixedRealityController API
  • Fixed an issue where the AR button was appearing as floating when looking down at steep angles

Occlusion Management

  • Fixed opaque appearance of Flakes Box shader in Play Mode on Unity 5 

Penguin

  • Unity iOS: Fixed issue where the Penguin app did not reset the scene when the Refresh button was clicked on iOS 8.4 device

Text Reco

  • Unity iOS: fixed issue of word bounding box not showing on iOS 8/9 64bit devices

Video Playback

  • Fixed issue with inconsistent updates of video frames when playing video on texture on iOS9.2 devices
  • Fixed issue with device sometimes getting in an undesirable state when playing the video in full screen landscape mode and returning to camera view
  • Fixed Video planes Z-fighting issue in Unity scene
  • Updated the Video content

Known Issues

Video Playback sample

  • Video Playback sample app may crash on iOS when the app is paused and resumed while the video is playing full screen

 

Native Samples 5.5.6

Bug-fixes / new features

Android

All samples

  • New ARVR sample application
  • New videos in the Video Playback  sample application
  • Use the new enum for QCAR::CameraDevice::CAMERA_DIRECTION
  • New icon and splash screen

 

iOS

All samples

  • New ARVR sample application
  • New videos in the Video Playback  sample application
  • New Image Targets OS metal sample application
  • Use the device native scale instead of the previously hard coded 2.0 value
  • Use the new enum for QCAR::CameraDevice::CAMERA_DIRECTION
  • New icon and splash screen

User Defined Targets

  • When enabling Extended Tracking, only the last created target is impacted

Video Playback

  • Fix issue with video starting in landscape on iPad

Unity Samples 5.0.10

Bug-fixes / new features

All Unity Samples

  • Upgraded sample code to support Unity 5.3 

AR-VR Sample

  • Implemented various scene enhancements to improve rendering performance and frame rate 
  • Fixed issue in reticle size calculation on GearVR 
  • Updated fade-to-black transition script to be compatible with Unity 5.3 VR support 

Text Reco sample

  • Updated sample code to use latest version of the iOS Device generation Unity API 

Known Issues

All Unity samples

  • Unity 5.3: Samples UI labels appear misaligned / not centered (Unity issue)

Occlusion Management sample 

  • Flakes box appears opaque in Unity 5 Editor

Penguin sample

  • Penguin sample app doesn't refresh the scene when refresh button is clicked on iOS 8.4 device

Text Reco sample

  • Text Reco sample on Unity doesn't display word bounding boxes in iOS 8.4 and iOS 9.x 64bit devices

Video Playback sample

  • Video Playback inconsistently updates video frames when playing video on texture on iOS9.2 devices
  • Playing the video in full screen landscape mode and returning to camera view sometimes puts the device in an undesirable state
  • Video Playback sample app may crash on iOS when the app is paused and resumed while the video is playing full screen

Java and C++ Samples 5.0.10

Bug-fixes / new features

Android

All samples

  • Migrated all Android sample projects to Android Studio

iOS

All samples

  • Sample apps may crash in OpenGL on iOS when the app is deactivated

Videoplayback sample

  • Video Playback inconsistently updates video frames when playing video on texture on iOS9.2 devices 


Unity Extension 5.0.5

New samples

  • Added an AR/VR sample showing how to create a mixed reality experience using either the Oculus SDK for Gear VR or the Cardboard SDK
  • Added a Stereo Rendering sample showing how to configure stereo rendering for optical see-through devices

All Unity Samples

  • Upgraded sample code to be fully compatible with Unity 5.1.x, including correct OpenGL ES Player Settings for Android and iOS 
  • Setting camera direction, flash, autofocus and extended tracking are now only demonstrated in the ImageTargets sample

Known Issues

Occlusion Management sample

  • Flakes box appears opaque in Unity 5 Editor

VideoPlayback

  • Unity iOS sample app crashes when pausing and resuming while video is playing full screen

Digital Eyewear

  • Vuforia apps using Cardboard may display visual artifacts in Unity 5.x, as documented in the Cardboard SDK relase notes. This issue can be fixed by enabling “Development build” in the Build Settings dialog (Android and iOS).
  • Vuforia apps using Cardboard SDK may run at a lower frame rate in Unity 5.1 than in Unity 4.6. Unity 4.6.7 is the recommended version for developing Vuforia 5.0 apps that use Cardboard.
  • Vuforia apps using the Gear VR OVR SDK may run at a lower frame rate in Unity 5.1 than in Unity 4.6. Unity 4.6.7 is the recommended version for developing Vuforia 5 apps that use the Gear VR.

Java and C++ Samples v5.0.5

Digital Eyewear

  • Added a Stereo Rendering sample for Android showing how to configure stereo rendering for optical see-through devices

iOS and Android Samples

  • Minor updated to the sample About screens to accurately reflect sample features and sample usage instructions.
  • Setting camera direction, flash, autofocus and extended tracking are now only demonstrated in the ImageTargets sample

iOS :

  • Updated all the iOS native samples to use Storyboards and Auto-layouts.

Vuforia Unity Extension 4.2.3

  • updated the Image Targets and Video Playback sample scenes to prevent a Unity Editor crash upon clicking on an Image Target

Image Targets

  • Fixed an issue in the Unity ImageTargets sample that caused a crash if the ImageTarget prefab instance was the first object selected in a newly loaded scene.

Video Playback

  • Fixed an issue in the Unity Video Playback sample that caused a crash if the ImageTarget prefab instance was the first object selected in a newly loaded scene.

Vuforia Unity Extension 4.0.105
 

All Samples

  • Upgraded Sample Orientation Setter script to correctly set screen orientation in Unity 5.0
  • Updated Splash Manager sample code to use UNITY_IOS platform definition for Unity 5.0 compatibility

Video Playback

  • Updated Editor script to be compatible with Unity 5.0 API
  • Upgraded code to be compatible with Unity 5.0 API
  • Fixed a black screen issue in full screen movie player, triggered on screen tap, on iOS
  • Fixed an issue with AR view being rendered upside-down after quitting the full screen movie player on iOS
  • Fixed an issue where the Sample Menu was not showing while Video was being played on target (video-on-texture)

Penguin

  • Updated ice surface shader to support correct transparency in Unity 5.0

Text Recognition

  • Upgraded code to be compatible with Unity 5.0 API

Books

  • Implemented correct asynchronous downloading of book data (fixing Play Mode error occurring in Unity 5.0)
  • Fixed issue with tap on Book texture failing to open Web view in Unity 5.0

Occlusion Management

  • Fixed issue with incorrect rendering of video background on Android when shader was active

Known issues:

All Samples

  • The video background is upside down when using the front device camera on the Nexus 6

Image Targets

  • The Unity 5.0 editor crashes when an ImageTarget prefab instance in the ImageTargets sample is selected prior to selecting another prefab in the hierarchy when the sample is first loaded. Selecting an alternate prefab, such as the ARCamera, after initially loading the sample scene will prevent this crash from ever occurring. 

Video Playback

  • For sample apps built from Unity 5.0, clicking back while the video is playing full screen in the video playback app doesn't render background on some Android Gingerbread devices
  • For sample apps built from Unity 5.0, the orientation repeatedly flips after full screen video playing on iOS 7. This only occurs in landscape mode

Books


Vuforia SDK v4.0.103

Native Apps 

  • Vuforia Samples 
  • Background Texture Access 
  • Books 
  • Dominoes 
  • Occlusion Management 
  • ​Video Playback 

iOS and Android: 

  • Error code handling has been added to manage errors arising from missing, invalid or revoked license keys.  

iOS : 

  • Fixed bug affecting screen size and device orientation on iOS8. 
  • Added camera access check handling for iOS8. 
  • Updated samples for 64-bit compatibility. 
  • Added native samples for Object Recognition. 

ImageTargetsNative 

Android: 

  • Error code handling has been added to manage errors arising from missing, invalid or revoked license keys. 

 


Unity 

All Samples 

  • Error code handling has been added to manage errors arising from missing, invalid or revoked license keys using newly implemented QCAR registration callbacks. 

Object Recognition 

  • New sample app introduced with this release.  

  • Sample doesn't come with a dataset. Please refer to appropriate documentation guide on how to create a dataset and setting up unity scene in the sample. 

Penguin 

  • Sample app implements new Smart Terrain APIs and design pattern.  

Smart Terrain 

  • Sample app implements new Smart Terrain APIs and design pattern.  

VideoPlayback 

  • Fixed bug that prevented the video from being updated after pausing and resuming the app on iOS8 

Known Issues 

CloudReco - iOS 

In the VuforiaSamples application, the cloud reco application doesn't trigger a focus when the user taps on the screen. The reason is that the gesture recognizer is created but not added to the view. 

There are 2 changes to perform in the file VuforiaSamples/Classes/apps/CloudReco/CloudRecoViewController.mm: 

- (void)viewDidLoad 
{ 
    [super viewDidLoad]; 
    [self prepareMenu]; 
    self.navigationController.navigationBar.translucent = YES; 
    // TODO: add this line 
    [self.view addGestureRecognizer:tapGestureRecognizer]; 
  
.../... 
}
The gesture recognizer needs to be destroyed when the controller is destroyed: 
- (void)dealloc 
{ 
    [[NSNotificationCenter defaultCenter] removeObserver:self]; 
    // TODO: add this line 
    [tapGestureRecognizer release]; 
 .../... 
}

 VideoPlayback - iOS 

In the VideoPlayback application, a tap on the screen doesn't trigger a focus. 

To enable this feature, add one line in VideoPlayback/VideoPlayback/Classes/apps/VideoPlayback/VideoPlaybackViewController.mm :  

// tap handler 
- (void)handleTap:(UITapGestureRecognizer *)sender { 
    if (sender.state == UIGestureRecognizerStateEnded) { 
        // handling code 
        CGPoint touchPoint = [sender locationInView:eaglView]; 
        [eaglView handleTouchPoint:touchPoint]; 
    } 
    // TODO: add this line 
    [self autofocus:sender]; 
}