vue-unity-webgl

Easy to use Unity 5.6 or newer (also Unity 2017 or newer) WebGL player component for your VueJS application. Embed your Unity application in your application for writing interactive interfaces with two way Unity and VueJS communication.

Install

npm install  https://github.com/votetake/vue-unity-webgl.git --save

Usage

To get stated import the Unity component from vue-unity-webgl. Once imported you can use the Unity component to load in your Unity content. Place the Unity tag along with a src to the json file Unity exported.

<template>
  <unity src="static/Build/game.json" width="1000" height="600" unityLoader="static/Build/UnityLoader.js"></unity>  
</template>

<script>
  import { Unity, Message } from 'vue-unity-webgl'
  
  new Vue({
    components: { Unity }
  })
</script>

Notice

Don't forget to add a script tag to load the UnityLoader.js file if miss unityLoader attribute, exported by Unity in your base html file, index.html in example.

Optional attributes

src - Path to json build
width - width div container
height - height div container
unityLoader - path to UnityLoader, with this

Communication

Unity allows you to send Javascript messages to the Unity content. In order to do so using VueJs you have to import the Message function from vue-unity-webgl. The first parameter is the target game object name, the next is the method name, and the last is a optional param value.

import { Message } from 'vue-unity-webgl'

new Vue({
  methods: {
    onClick () {
      Message ("object", "method", "param");
    }
  }
})

styling

The player will be injected in the a component with the class unity-container. To style to player use the following sass styling. To style the loader you can style the component with the class unity-loader. See the example below.

.unity {
    .unity-container {
        canvas {
            
        }
    }
    .unity-loader {
        .bar {
            .fill {
                /* the width will be set by the component */
            }
        }
    }
}

html example

<!DOCTYPE html>
<html>
    <head>
        <title>My Unity Game</title>
    </head>
    <body>
        <div id="app"></div>
    </body>
    <script src="Build/UnityLoader.js"></script>
    <script src="static/compiled/bundle.js"></script>
</html>

Rocher0724/vue-unity-webgl