❤
npm
Sign UpSign In

aframe-video-billboard

1.0.2 • Public • Published

aframe-video-billboard

A Video Billboard entity & component for A-Frame.

Create an <a-video-billboard /> entity, streaming video from the user's camera to a plane in 3D space.

Note: Requires the latest WebRTC spec. This can be easily shimmed with webrtc-adapter

By default, will select the "back" facing camera.

Installation

Browser

Use directly from the unpkg CDN:

<head>
  <script src="https://aframe.io/releases/0.3.0/aframe.min.js"></script> 
  <script src="https://unpkg.com/webrtc-adapter/out/adapter.js"></script> 
  <script src="https://unpkg.com/aframe-video-billboard"></script> 
  <script>
    registerAframeVideoBillboard(window.AFRAME);
  </script> 
</head>
 
<body>
  <a-scene>
    <a-video-billboard position="0 0 -5"></a-video-billboard>
    <a-camera></a-camera>
  </a-scene>
</body>

npm

Install via npm:

npm install aframe-video-billboard

Then register and use.

import aframe from 'aframe';
import registerVideoBillboard from 'aframe-video-billboard';
registerVideoBillboard(aframe);

video-billboard component

Note: The <a-video-billboard> entity automatically includes the video-billboard component.

Schema

attribute type default description
deviceId string '' Select the specific device for display. If omitted, will attempt to get the rear-facing video stream. If rear-facing video stream not detected, will get the first video stream found. Note that if it is not a valid video device, nothing will be shown.
minWidth number 4 The minimum width in world-units to display the video. Video aspect ratio will be preserved.
minHeight number 3 The minimum height in world-units to display the video. Video aspect ratio will be preserved.

Events

event name data description
video-play {source, stream} source is an instance of MediaDeviceInfo. stream is an instance of MediaStream. Fired every time the source changes and video playback begins.

Dependencies (3)

Dev Dependencies (27)

Package Sidebar

Install

npm i aframe-video-billboard

Repository

github.com/jesstelford/aframe-video-billboard

Homepage

github.com/jesstelford/aframe-video-billboard#readme

Weekly Downloads

2

Version

1.0.2

License

MIT

Last publish

Collaborators

  • jesstelford
Try on RunKit
Report malware