Upload Web App
The Upload Web App is a browser-based tool for uploading scenes and dynamic objects to the Cognitive3D spatial analytics platform. It provides a graphical interface for developers who are working with platforms that do not have built-in upload tools, such as visionOS, WebXR, and Android XR.
Live App: upload.cognitive3d.com
Who Is This For?
The Upload Web App is designed for developers using:
- Apple visionOS SDK - Swift developers building spatial computing experiences
- WebXR SDK - JavaScript developers creating browser-based XR applications
- Android XR SDK - Kotlin/Java developers building for Android XR devices
- C++ SDK - Developers using the native C++ SDK
- Any platform without a built-in scene/object upload GUI
If you are using Unity or Unreal Engine, the SDK includes built-in upload tools within the editor. You typically do not need the Upload Web App unless you prefer a web-based workflow.
Prerequisites
Before using the Upload Web App, you need:
- A Cognitive3D account - Sign up at cognitive3d.com
- A Project - Create a project in your organization
- A Developer API Key - Found in Organization Settings
Use Developer API Key, Not Organization API Key
The Upload Web App requires a Developer API Key (starts with a long alphanumeric string). Do not use an Organization API Key (starts with "org"). If you see authentication errors, verify you are using the correct key type.
Quick Workflow Overview
The Upload Web App supports four operations:
| Operation | Description |
|---|---|
| New Scene | Upload a new scene to your project |
| Update Scene | Upload a new version of an existing scene |
| New Object | Upload a new dynamic object to a scene |
| Update Object | Upload a new version of an existing dynamic object |
Basic Steps
- Go to upload.cognitive3d.com
- Enter your Developer API Key to authenticate
- Select your upload type (new scene, update scene, new object, or update object)
- Drag and drop your files or click to browse
- Verify the file validation passes
- Click Upload and wait for completion
After uploading scenes, they appear in the "Your Scenes" list with quick actions to update the scene or add dynamic objects.
File Requirements Summary
Scene Files
| File | Required | Description |
|---|---|---|
scene.gltf |
Yes | 3D scene geometry in glTF format |
scene.bin |
Yes | Binary data for the glTF file |
screenshot.png |
Yes | Scene thumbnail (recommended 512x512) |
| Texture files | No | PNG/JPG textures referenced by the glTF |
See Scene Uploads for detailed instructions.
Dynamic Object Files
| File | Required | Description |
|---|---|---|
{name}.gltf or {name}.glb |
Yes | 3D mesh in glTF or GLB format |
{name}.bin |
Yes* | Binary data (required for .gltf, not for .glb) |
screenshot.png or cvr_object_thumbnail.png |
Yes | Object thumbnail |
| Texture files | No | PNG/JPG/WEBP textures referenced by the mesh |
See Object Uploads for detailed instructions.
No 3D Files? Use Sample Assets
If you are just getting started and do not have 3D assets prepared, the Upload Web App provides sample files:
- Empty Scene - A minimal scene with a small cube, useful for testing your SDK integration without preparing custom 3D assets
- Sample Object - A default cube object for testing dynamic object tracking
These options appear when you select "New Scene" or "New Object" without having files ready.
Related Documentation
- Scene Uploads - Detailed guide for uploading scenes
- Object Uploads - Detailed guide for uploading dynamic objects
- Concepts - Understanding Scenes, Sessions, and Dynamic Objects
- Organization Settings - Finding your Developer API Key
- Scene Viewer - Viewing your uploaded scenes
- Object Explorer - Viewing your uploaded dynamic objects
SDK-Specific Guides
CLI Upload Tools
For automated workflows or CI/CD pipelines, command-line upload tools are available as an alternative to the Upload Web App.
The c3d-upload-tools repository provides CLI scripts for uploading scenes and dynamic objects directly from a terminal. This is useful for:
- Automated build pipelines
- Batch uploading multiple scenes or objects
- Integration with CI/CD systems
- Scripted deployment workflows
See the README in that repository for installation and usage instructions.
If you have a question or any feedback about our documentation please use the Intercom button (purple circle) in the lower right corner of any web page or join our Discord.