November 6, 2019 update:
  • There's a new open source Cardboard SDK for iOS and Android NDK that offers a streamlined API, improved device compatibility, and built-in viewer profile QR code scanning. A corresponding Unity package (SDK) is planned for a future release. We recommend that all developers actively building for Google Cardboard migrate (iOS, Android NDK) to the new Cardboard SDK.
October 15, 2019 update:
  • The Daydream View VR headset is no longer available for purchase. However, you can continue to use the existing Google VR SDK to update and distribute your apps to the Google Play Store, and make them available to users in the Daydream app.

GVRVideoView Class

GVRVideoView Class Reference

Overview

Defines a player view that renders a 360 video using OpenGL.

Inherits GVRWidgetView.

Instance Method Summary

(void) - loadFromUrl:
 Load a local or remote video from a url and start playing. More...
 
(void) - loadFromUrl:ofType:
 Load a local or remote video from a url and start playing. More...
 
(void) - pause
 Pause the video. More...
 
(void) - play
 Start or resume the video. More...
 
(void) - stop
 Stop the video. More...
 
(NSTimeInterval) - duration
 Get the duration of the video. More...
 
(NSTimeInterval) - playableDuration
 Gets the playable duration of the buffered video. More...
 
(void) - seekTo:
 Seek to the target time position of the video. More...
 

Class Method Summary

(void) + setViewerParamsFromUrl:withCompletion:
 Sets the Cardboard viewer parameters from a Url. More...
 

Property Summary

float volume
 Defines a volume multiplier between 0.0f and 1.0f on the media audio playback. More...
 
id< GVRWidgetViewDelegatedelegate
 The delegate that is called when the widget view is loaded. More...
 
BOOL enableFullscreenButton
 Displays a button that allows the user to transition to fullscreen mode. More...
 
BOOL enableCardboardButton
 Displays a button that allows the user to transition to fullscreen VR mode. More...
 
BOOL enableInfoButton
 Displays a button that allows the user to get more information about VRView. More...
 
BOOL hidesTransitionView
 Hides the transition view when entering VR mode. More...
 
BOOL enableTouchTracking
 Enables touch gesture detection for manual heading control. More...
 
GVRHeadRotation headRotation
 The current head rotation corresponding to where the user is looking. More...
 
GVRWidgetDisplayMode displayMode
 Controls the current ::GVRWidgetDisplayMode of the widget view. More...
 

Method Detail

- (void) loadFromUrl: (NSURL *)  videoUrl

Load a local or remote video from a url and start playing.

The video is assumed to be of type ::kGVRVideoTypeMono.

- (void) loadFromUrl: (NSURL *)  videoUrl
ofType: (GVRVideoType)  videoType 

Load a local or remote video from a url and start playing.

The video type is set by videoType.

- (void) pause

Pause the video.

- (void) play

Start or resume the video.

- (void) stop

Stop the video.

- (NSTimeInterval) duration

Get the duration of the video.

- (NSTimeInterval) playableDuration

Gets the playable duration of the buffered video.

- (void) seekTo: (NSTimeInterval)  position

Seek to the target time position of the video.

+ (void) setViewerParamsFromUrl: (NSURL *)  url
withCompletion: (void(^)(BOOL success, NSError *error))  completion 

Sets the Cardboard viewer parameters from a Url.

This allows programmatically pairing a viewer without having the user go through the pairing flow. Calls the supplied completion handler with the result of pairing and the error if it fails.

Note: The viewer parameters can be set only if no other viewer pairing exists. In other words, this only works if the user hasn't already paired a viewer for the current application.

A valid viewer parameters URI can be generated from this page: https://www.google.com/get/cardboard/viewerprofilegenerator/

Property Detail

- (float) volume
readwritenonatomicassign

Defines a volume multiplier between 0.0f and 1.0f on the media audio playback.

This setting persists across multiple videos. 0.0f means muted, while 1.0f means regular volume. Default value is 1.0f.

- (id<GVRWidgetViewDelegate>) delegate
readwritenonatomicweakinherited

The delegate that is called when the widget view is loaded.

- (BOOL) enableFullscreenButton
readwritenonatomicassigninherited

Displays a button that allows the user to transition to fullscreen mode.

- (BOOL) enableCardboardButton
readwritenonatomicassigninherited

Displays a button that allows the user to transition to fullscreen VR mode.

- (BOOL) enableInfoButton
readwritenonatomicassigninherited

Displays a button that allows the user to get more information about VRView.

- (BOOL) hidesTransitionView
readwritenonatomicassigninherited

Hides the transition view when entering VR mode.

- (BOOL) enableTouchTracking
readwritenonatomicassigninherited

Enables touch gesture detection for manual heading control.

Regardless of how this is set, touch tracking is disabled in fullscreen VR mode.

- (GVRHeadRotation) headRotation
readnonatomicassigninherited

The current head rotation corresponding to where the user is looking.

- (GVRWidgetDisplayMode) displayMode
readwritenonatomicassigninherited

Controls the current ::GVRWidgetDisplayMode of the widget view.

Changing the value of this property is similar to pressing one of the fullscreen, cardboard or back UI buttons.