Captures and uploads

How to capture photos, videos, and audio, and how uploads work in the Ango Hub App.

Upload-box questions in the Ango Hub App can collect photos, videos, and audio from the user's device.

The available buttons depend on the upload box's accepted formats. For example, a video upload box shows Record Video, while an image upload box shows Take Photo.

If an upload box is configured with file formats that are not supported on mobile, the app shows an unsupported-format message for that upload box.

Supported upload-box media

The app supports common mobile media formats, including:

• Images such as .jpg, .jpeg, .png, .heic, .webp, .gif, .tif, and .tiff.

• Videos such as .mp4, .mov, .avi, .mkv, and .webm.

• Audio such as .m4a, .aac, .mp3, .wav, and .ogg.

The maximum file size for a single mobile upload is 4.5 GB.

Capturing media

Tap the upload-box action button to capture or select media.

Depending on the accepted formats, the app can:

• Take a photo with the camera.

• Record a video with the camera and microphone.

• Record audio with the microphone.

• Choose an existing photo or video from the device library.

Video capture supports portrait and landscape recording. Before recording, the app asks you to match the selected orientation. Once recording starts, the recording orientation is locked.

For video capture, you can lock the on-screen controls during recording to avoid accidental taps.

During video capture, the app shows recording controls and any active Hand Detection guidance.

Choosing from the gallery

For image and video upload boxes, users can choose existing media from the device gallery.

On iOS, the app uses its own gallery picker so it respects the user's selected Photos access. If access is limited, tap Manage Selection to allow more photos or videos.

On Android, the app uses the system photo picker.

When Hand Detection is enabled for a video upload box, gallery videos are not accepted for that upload box. The user must record the video in the app so the hand-detection check can run.

Previewing a capture

After taking a photo, recording video, recording audio, or choosing media from the gallery, the app opens a preview screen.

From the preview, tap Use to attach the media to the upload box. Tap Retake to discard it and capture again.

If Save captures to gallery is enabled in Settings, the app also saves a copy of captured photos and videos to the device gallery. The capture is still uploaded to Ango Hub even if saving the extra gallery copy fails.

The preview screen shows the captured media before the user attaches it to the upload box.

Uploading and submitting

After you tap Use, the media is staged on the device and queued for upload.

In the task, the upload box shows whether the file is ready to save, uploading, finalizing, uploaded, or failed.

After a capture is selected, the upload box shows the local file status before the task is saved or submitted.

If you save or submit while media is still uploading, the app keeps tracking the upload in the Uploads tab. When the upload finishes, the app patches the task answer with the uploaded file URL.

The Uploads tab shows all pending and recently completed mobile uploads. From there, you can:

• Pause all uploads.

• Resume all uploads.

• Retry failed uploads.

• Cancel queued or failed uploads.

• Return to a task when a submission needs review.

• Retake or delete a capture that was blocked by Hand Detection.

Uploads automatically pause when the device is offline. If Upload over Wi-Fi only is enabled, uploads pause while the device is not connected to Wi-Fi.

Completed upload files are kept locally for a short retention window and then removed from the device.

The Uploads tab tracks queued, submitted, failed, and recently completed mobile uploads.

Hand Detection for video collection

The app includes optional Hand Detection for video upload boxes.

When Hand Detection is enabled, the app checks for hands during in-app video recording. Recording waits until the required number of hands are visible. If hands leave the frame during recording, the app can play a warning sound, show an on-screen warning, and use haptic feedback.

Hand Detection can also block uploads when the recorded video does not satisfy the configured hand-presence requirements. If that happens, the upload is not submitted and the user is asked to retake the recording.

When a Hand Detection check blocks an upload, the app asks the user to retake the recording.

Users can turn Hand Detection on or off from Settings, and adjust advanced detection settings from Settings > Advanced detection settings.

Changing Hand Detection settings only affects new recordings. It does not change recordings already in progress or captures already queued for upload.