Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/oscarmarinmiro/aframe-video-controls
AFrame component to control (play/pause/jump) videos.
https://github.com/oscarmarinmiro/aframe-video-controls
Last synced: about 1 month ago
JSON representation
AFrame component to control (play/pause/jump) videos.
- Host: GitHub
- URL: https://github.com/oscarmarinmiro/aframe-video-controls
- Owner: oscarmarinmiro
- License: mit
- Created: 2016-06-04T00:11:56.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2016-11-01T21:24:13.000Z (about 8 years ago)
- Last Synced: 2024-10-14T01:11:22.611Z (2 months ago)
- Language: JavaScript
- Homepage: https://oscarmarinmiro.github.io/aframe-video-controls/
- Size: 11.6 MB
- Stars: 55
- Watchers: 7
- Forks: 24
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## aframe-video-controls
A video control component for [A-Frame](https://aframe.io). Demo [here] (https://oscarmarinmiro.github.io/aframe-video-controls)
It attaches to a video asset so you can play/pause the video (assuing it is projected on a plane or sphere) by looking and clicking on the 'play' icon or transport bar.
You can also press the 'space bar' or the arrow keys to control the video if you are in a 'desktop' computer
#### Feedback is needed and very welcome, specially regarding User Experience!!!
I'm working on the following features, but feel free to suggest via Github Issues:
- 'Flat' component if on Desktop (i.e: not in the 3D space)
- Test on iPhone and Vive (at the moment I tested this in Android, Cardboard and Oculus Rift DK2)
- Test on much bigger files
- Volume controls
- Another control to jump between different files so you can 'browse' different videos
- 'Auto hide feature': If x seconds have passed after last interaction with player, hide the controls and A-Frame cursor
### Demo
You can play with a live demo [here] (https://oscarmarinmiro.github.io/aframe-video-controls)
### Properties
| Property | Description | Default Value |
| -------- | ----------- | ------------- |
| src | selector of the video asset | mandatory |
| size | horizontal size of the player in meters | 1.0 |
| distance | distance of the player from the camera in meters | 2.0 |
| backgroundColor | Color of the player background. | black |
| barColor | Color of the video progress bar. | red |
| textColor | Color of the text. | yellow |
| infoTextBottom | Bottom text to display under the bar to explain how to use it. | Double-click outside player... |
| infoTextTop | Top text to display under the bar to explain how to use it. | Look+click on play... |
| infoTextFont | Font for info text. | 35px Helvetica Neue |
| statusTextFont | Font for text to right of player. | 30px Helvetica Neue |
| timeTextFont | Font for time progress. | 70px Helvetica Neue |
### Usage
Just include the component and put your video into the A-frame assets section.
Then just include an entity with the 'src' attribute 'pointing' to the video asset you want to control.
You can supply your own 'play' and 'pause' images for the player by including these lines into the assets of your scene:
```html
...
```
Otherwise, the default 'play' and 'pause' images (CDN-hosted) will be used.
#### Browser Installation
Install and use by directly including the [browser files](dist):
This example projects a 360 video into a videosphere and attaches the controls to it.
```html
My A-Frame Scene
```
#### NPM Installation
Install via NPM:
```bash
npm install aframe-video-controls
```
Then register and use.
```js
require('aframe');
require('aframe-video-controls');
```