Metadata Settings
With the release of version 1.25 of Littlstar VR Cinema on the PSVR, render settings such as video type, layout, and frame packing can now all be changed on the fly within the app itself. This means that users no longer have to worry about the filename to tell the player how to render the video. Metadata files are currently mapped to the filename itself, meaning that if you change the filename after setting the metadata, those changes will not be reflected. If you change the filename, the metadata for the video will have to be set again. In the future, metadata files will be able to adapt to filename changes.
NOTE: As of now, it is not recommended to edit these metadata files. In the future, they will be more versatile and allow for the editing of the video's title, description, and thumbnail.
Content Type
App Setting | Json Descriptor | Description |
---|---|---|
FF | FF | The video is a fixed frame, non-spherical video. |
180 | Spherical_180 | The video is a spherical 180 degree video. |
360 | Spherical_360 | The video is a spherical 360 degree video. |
Content Type will default to FF if no type is provided.
Content Layout
App Setting | Json Descriptor | Description |
---|---|---|
2D | Mono | The video is a 2D, monoscopic video. |
OU/TB | OU_TB | The video's frames are vertically aligned. |
LR/SBS | LR_SBS | The video's frame are horizontally aligned. |
Content Layout will default to 2D if no layout is provided.
Frame Packing
This feature is typically reserved for 3D FF videos. For more information, visit this link.
App Setting | Json Descriptor | Description |
---|---|---|
HALF | HR | The frame's resolution is halved to ensure the full stereoscopic image fits into a normally-sized 2D frame. |
FULL | FR | The two stereoscopic images are merged into a single frame, double the size of a 2D video's frame. |
If the video is a 3D FF video, the frame packing method will default to HALF resolution. Otherwise, it will be FULL.
Metadata File Specification
The metadata file uses a .json
format.
Note: This specification is under development and may change.
Elements
Field | Description | Type | Values |
---|---|---|---|
title | The name of the item | string | Any |
description | The description of the item | string | Any |
duration | Total running time of video in seconds | float | Any |
ls:content-type | The content type of the item | string | "FF", "Spherical_180", "Spherical_360" |
ls:content-layout | The content layout of the item | string | "Mono", "OU_TB", "LR_SBS" |
ls:frame-packing | The frame packing of the item | string | "NotAvailable", "HR", "FR" |
Example
{ "title":"Test Video", "description":"A video for testing", "duration":135.7, "ls:content-type":"Spherical_180", "ls:content-layout":"LR_SBS", "ls:frame-packing":"NotAvailable" }