Skip to content

Latest commit

 

History

History
127 lines (89 loc) · 3.33 KB

index.md

File metadata and controls

127 lines (89 loc) · 3.33 KB
Raw
title
PlayKit Virtual Reality (VR) for iOS

PlayKit VR for iOS

{:.no_toc}

PlayKit VR is an iOS library that is used for monoscopic 360 video play back and VR. The VR view allows you to embed 360 degree VR media into mobile, and native applications on iOS. This technology is designed to enable developers of traditional applications to enhance their applications with immersive content.

  • TOC {:toc}

Supported Features

Features
Monoscopic 360 video playback (Panorama View).
Split screen option for VR (Stereo View).
Built on top of SceneKit + Metal
Distorted stereo view for Cardboard
Smooth touch rotation and re-centering
Custom SCNScene presentation
Written in Swift 3
Monoscopic-360 Stereoscopic

Supported Platforms

  • Xcode 8.2+
  • iOS 9.0+
  • Swift 3.0+
  • Metal (Apple A7+)

Supported Formats

  • HLS
  • MP4

Known Limitations

  • Metal is not supported in the iOS Simulator; please run your application on an actual device.

Installation

CocoaPods

Add the following to your podfile:

pod 'PlayKitVR'

Overview

Simple Flow

Usage

General API Notes

The following classes/interfaces are the public API of the library:

  • PKVRController - Use this class to interact with the library.

Basic Implementation

override func viewDidLoad() {
        super.viewDidLoad()
        
        // 1. Load the player
        do {
            self.player = try PlayKitManager.shared.loadPlayer(pluginConfig: nil)
            
            // 2. Prepare the player (can be called at a later stage, preparing starts buffering the video)
            self.preparePlayer()
        } catch let e {
            // error loading the player
            print("error:", e.localizedDescription)
        }
    }
    
/************************/
// MARK: - Player Setup
/***********************/
    func preparePlayer() {
        // setup the player's view
        self.player?.view = self.playerContainer
        
        let serverURL = "https://cdnapi.kaltura.com"
        let partnerId = 1424501
        
        let sessionProvider = SimpleOVPSessionProvider(serverURL:serverURL, partnerId: Int64(partnerId), ks: nil)
        let mediaProvider: OVPMediaProvider = OVPMediaProvider(sessionProvider)
        mediaProvider.entryId = "0_a54foq3g"
        mediaProvider.loadMedia { (mediaEntry, error) in
            if(!(error != nil)) {
                // create media config
                let mediaConfig = MediaConfig(mediaEntry: mediaEntry!)
                self.player!.prepare(mediaConfig)
            }
        }
    }
    
 /************************/
// MARK: - VR
/***********************/
    
    @IBAction func setVRMode(_ sender: Any) {
        // 3. Get PKVRController
        let vrController = self.player?.getController(ofType: PKVRController.self)
        // 4. Use PKVRController API
        vrController?.setVRModeEnabled(true)
    }

VR Basic Sample

For a basic PlayKit VR sample click here