/STYLY-Spatial-Layer-Plugin

Unity plugin to upload your contents to Vision Pro via STYLY

Primary LanguageC#MIT LicenseMIT

STYLY Spatial Layer Plugin for Vision Pro

Kujira

What is this plugin?

Notes

  • Contents of STYLY for Vision Pro is not compatible with STYLY for other platforms (STYLY VR or STYLY mobile).
  • STYLY for Vision Pro doesn't have 3D contents assembly tools for now.
  • Please give us your feedback on Github Issues.
  • Your contents will be PUBLIC once your uploaded. Don't upload your contents which you want to keep private.
  • The content gallery on the STYLY app is now managed on a whitelist basis. Please apply through this APPICATION FORM if you want your content to get listed.

Requirements

  • Unity
    • Unity 2022.3.27 or later (Use 2022.3.XX)
    • Modules:
      • visionOS Build Support
    • Render pipelines: URP
    • Color Space: Linear
  • Xcode (if you want to test with visionOS simulator)
    • Xcode 15.2 or later
    • Apple Silicon Mac (M1/M2/M3)

Links

Supported features for STYLY visionOS Plugin

  • Mixed Reality mode: Bounded Volumes, Unbounded Volumes
  • Standard URP materials: Lit, Simple Lit, Unlit (and some spacial materials)
  • Visual Scripting
  • Timeline, animator, animation, audioclip and other basic features. See Supported Unity Features and Components page for the detail.

NOT Supported features for STYLY visionOS Plugin

  • Fully Immersive VR, Windowed Apps
  • Scripting in C#
  • Custom shaders / Shader Graph
  • Visual Effect Graph

Supported Visual Scripting Unity packages

You are moe than welcome to recommend new custom Visual Scripting nodes to support.

How to setup

Unity
  • Install Unity 2022.3.27 or later (Use 2022.3.XX) via Unity Hub with modules:
    • visionOS Build Support
Setup Unity project
    # Install openupm-cli
    npm install -g openupm-cli

    # Go to your unity project directory
    cd YOUR_UNITY_PROJECT_DIR

    # Install STYLY plugin for Unity
    openupm add -f com.styly.styly-spatial-layer-plugin
    # Install supported packages for STYLY
    openupm add -f com.styly.package-collection-spatial-layer
Xcode
  • Install Xcode 15.2 or later with visionOS simulator. Xcodes is the easiest way to install and manage multiple versions of Xcode.
  • Open Simulator from Xcode menu. ClickXcode -Open Developer Tool -Simulator
  • Open Vision Pro simulator from menu. ClickFile -Open Simulator -visionOS 1.0 -Apple Vision Pro
Install STYLY for Vision Pro into the visionOS simulator
  • Install STYLY for visionOS into the simulator

How to build and upload contents

Unity prefab can be built and uploaded to STYLY. Right click a prefab in a project window and select STYLY - Build Content FIle

Right Click

Built file will be created as yyyyMMddHHmmss.styly in _Output directory in your project. Output file

STYLY for visionOS webpage will be opened in a browser. Login with your STYLY account.

Upload your built contents (.styly file) with its title, description and display type.

  • Bounded: Your contents will be displayed in 1m x 1m x 1m size. Contents can be displayed with other apps.
  • Unbounded: Your contents will be displayed exclusively in a space.

upload

How to play the contents on STYLY

  • Open content page on visionOS simulator. You can copy and paste your URL of the content from your Mac to the simulator.
  • Click Play on device on the page.
  • Your content will be displayed.

STYLY-XR-Rig (Add-on)

Right click at hierarchy window to install STYLY-XR-Rig, which allows you to develop and test adovanced features. You need a Unity Pro license to install it. Install STYLY-XR-Rig