Skip to content

Takes

Takes are a way to define a recording session. A single take can be associated with a video file and optionally additional files. Currently, we support the following additional file types:

  • DEPTH
  • INTRINSIC
  • ODOMETRY
  • VISION
  • MOVE

Currently only move file is supported and the other additional file types are planned for future releases.

Creating a singlecam take

mutation CreateSingleCamTake {
    take: createSingleCamTake(
        sources: [{
            deviceLabel:"human-readable-device-label",
            fileId: "file-2be2463e-ffa3-419b-beb4-ea0f99c79592",  // (1)
            format:MP4
        },
        {
            deviceLabel:"human-readable-device-label",
            fileId:"file-2f6e07be-19b1-49e8-b136-513be3f66560",  // (2)
            format:MOVE
        }]
    ) {
        id
    }
}
  1. This is the original video file id. This is typically the RGB video file to be used for the take.
  2. This is the file id for the move file. This is typically the move (protobuff) file to be used for the take.

Response:

{
    "data": {
        "take": {
            "id": "take-2be2463e-ffa3-419b-beb4-ea0f99c79512"
        }
    }
}

Querying for a take

{
    getTake(takeId: "take-2be2463e-ffa3-419b-beb4-ea0f99c79512") {
        id
        sources {
            file {
                id
                presignedUrl
            }
        }
    }
}

Response:

{
  "data": {
    "getTake": {
      "id": "take-2be2463e-ffa3-419b-beb4-ea0f99c79512",
      "sources": [{
        "id": "file-2be2463e-ffa3-419b-beb4-ea0f99c79592",
        "presignedUrl": "https://s3.eu-central-1.amazonaws.com/move-ugc-api-dev-.../file-2be2463e-ffa3-419b-beb4-ea0f99c79592.mp4?..."
      }]
    }
  }
}