How to: Get User’s Videos from Local and Cloud Storage

Xbox One provides a standard way for users to create recordings of in-game events and share them. Titles have access to these recordings to create custom experiences and extend interactivity.

Videos are held in local storage on the Xbox One console until there is sufficient network bandwidth to upload the video without impacting other activities the user might be doing. Consequently, it may be a matter of hours before videos are fully processed and available via the retrieval APIs.

It is possible for a title to access the local storage for the signed-in user. To do so, the title would use one API to query for clips, and another to retrieve individual clips.

Titles might wish to do this if they want to display videos created during a gameplay session immediately after the session ends, for example.

Query for the Game Clips

You will use the ApplicationClipQuery API to return local and cloud clips for the user on whose behalf the request is made. It can return clips based on the user or the user plus a SCID.

Get a Game Clip

ApplicationClipQuery will return ApplicationClip objects, which include a list of locations where the clip can be accessed. The ApplicationClip object also contains URIs to thumbnails for the video, the local ID and/or cloud ID of the videos, the date the recording started, timespan of the recording, multiplayer session ID, file size in bytes.

Note

The API will return the name of the clip in GreatestMomentId, but for local clips will not include the actual localized string.

Finally, the API will return TitleData, a string the title may write anything to, for its own use.