Render settings such as video type, layout, and frame packing can all be changed on the fly within the app itself. This means that you no longer have to worry about the filename of your sideloaded videos to tell the player how to render them. 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.
Enabling/Disabling Metadata Writing
Writing metadata to the sideload drive can be enabled/disabled from the Settings section in Library View as shown below. By default, the setting is enabled. If this setting is disabled, any changes to the metadata will not be saved for subsequent sessions.
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 frames 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 active 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 the 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"
}