Uploading Media to RealityPipe

RealityPipe currently supports photos and videos. There are two ways to upload content to RealityPipe. Depending on the type of application you have, you can:

1. Upload as file

You send the file as FormData.

RealityPipe currently supports photos and 360 videos.

Formats supported

Media Type	Extension
Photo	JPG, JPEG
Video	MP4

Once you upload you'll get a JSON response with contentID. This ID is unique to the media you upload to RealityPipe. This will be later used to display your VR content.

To see detailed information about the response, refer to Responses section

Send POST request to

  https://api.viewport.teliportme.com/contents/?sdk=vjs-0.1

The FormData should contain the following fields.

  file: <file_to_upload>,
  media_type: "sphere"

2. Upload via URL

Send the URL of the media and RealityPipe will download the media and take care of the rest.

Uploading via URL also supports same formats as uploading via file.

Send a POST request to RealityPipe API.

The response from the API is similar to upload via file, which you can refer here.

To upload the media via a URL, send a POST request to

  https://api.viewport.teliportme.com/contents/?sdk=vjs-0.1

as JSON with url as follows.

  {
    "url": "<url_of_media>",
    "media_type": "sphere"
  }

Responses

Once you send a file to RealityPipe, it will respond with a JSON object once the upload is complete.

The response section of the JSON response contains all the info necessary to access and display the VR content.

`contentId`

This is the unique ID assigned to your content when it is uploaded to RealityPipe. To display the VR content, this ID should be passed to the viewer SDK.

To learn how to display your virtual reality after uploading, refer to viewing in VR.

{
  "meta": {
    "version": "0.0.1",
    "type": "guest"
  },
  "response": {
    "contentType": "image",
    "contentId": "39c3db5ce2f511e6983c0242ac110006",
    "originalContentUrl": "https://s3-us-west-2.amazonaws.com/viewport-image/3665faa8e2f511e6983c0242ac110006.jpg",
    "metaContentUrl": "",
    "geometryMetaUrl": "",
    "createdOn": "2017-01-25T11:55:54.585357Z",
    "rendererId": "3665faa8e2f511e6983c0242ac110006",
    "mediaType": "sphere",
    "renderableUri": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/3072/verticalStrip.jpg",
    "thumbnailUp": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_u.jpg",
    "thumbnailRight": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_r.jpg",
    "thumbnailLeft": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_l.jpg",
    "thumbnailDown": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_d.jpg",
    "thumbnailFront": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_f.jpg",
    "thumbnailBehind": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_b.jpg",
    "thumbnailDefault": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006/512/512/face_b.jpg",
    "renderableCDN": "https://d1209dtsu93ybf.cloudfront.net/viewport/3665faa8e2f511e6983c0242ac110006",
    "supportedRenderers": [
      "ios-v0.0.1",
      "android-v0.0.1",
      "webgl-v0.0.1"
    ]
  }
}

Uploading Media