> For the complete documentation index, see [llms.txt](https://docs.snapfix.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md).

# Camera

{% hint style="info" %}
Draft, written by an agent and not yet checked by a person ([how to read these docs](https://docs.snapfix.com/how-to-read.md)). Platforms: iOS and Android. [Source on GitHub](https://github.com/snapfix/docs/blob/main/spec/screens/tasks/camera.md).
{% endhint %}

Start a new task from a photo, a video or an item from the phone's gallery, or go on to draw a sketch or write text.

* **Where:** iOS and Android: bottom bar "Snap"; the "+" menu, "Create a new task"; the camera or "+" inside a group, a room or an area; iOS also the home-screen quick action "Create a Task"
* **Who:** any signed-in user with a site. "Snap" opens the camera for everyone; the "+" menu offers "Create a new task" only to members of at least one task group on the current site. Finishing the task needs a group where the user may create tasks ([Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md)).
* **Feature:** [Creating tasks](https://docs.snapfix.com/product/features/tasks/task-creation.md)

The same screen also takes photos for task chat, checklists, planned tasks and asset photos. This doc covers new tasks. On Android, when the asset register list is showing, "Snap" starts a new asset instead of a task ([Asset registers](https://docs.snapfix.com/how-the-apps-work/screens/assets/registers.md)).

## Before the camera opens

From Home ("Snap" and the "+" menu) the apps check location and camera access first. Inside a group, room or area the group screen runs its own checks ([Group tasks](https://docs.snapfix.com/how-the-apps-work/screens/tasks/group-tasks.md)).

**iOS**

1. Location: when permission was never asked, the app shows the system prompt ("Your current location will be used when creating a new task. The new task location will be set to your current location"). From the "+" menu the flow goes on after the answer; from "Snap" nothing happens and the user has to tap "Snap" again. With permission, "Getting Location..." shows until a position arrives. With location services off, or when the position fails, the alert "Looks like GPS is not available. We will use the last known GPS location for this new task. You may wish to manually alter this location later." appears, and "Ok" goes on with the last known position. Denied permission goes on silently with the last known position, or 0,0.
2. Camera: when never asked, the system prompt ("The camera will be used when you want to take a photo associated with a task or add a photo to a message."); granted opens the camera, refused does nothing. When denied before, the alert "IMPORTANT" with the same text, "GO TO SETTINGS" and "Cancel".

The quick action "Create a Task" opens the camera 2.5 seconds after the tap without either check, so its task has location 0,0, and a denied camera shows the library's own alert titled "AVCam".

**Android**

1. Location: the system prompt; the camera opens whatever the answer. The position itself is read later, when the task is saved.
2. Camera, microphone, and on Android 12 and older also storage: all must be granted. The first refusal does nothing. After an earlier refusal the app explains "To capture photo for create task allow Snapfix to access your camera and your device's storage. And for video recording allow Snapfix to access you device microphone." with "Continue" and "Not now". Once the system stops asking, it shows the same text plus "Tap on Go to settings > permission and allow permissions." with "Go to settings" and "Not now".

## Layout

* **Preview:** the rear camera, full screen.
* **Top bar:** close, flash, switch camera, scan.
* **Recording timer:** "00:00", with a progress line and a ring around the capture button, only while a video records.
* **Bottom bar:** "Gallery" and "Video" on the left, the capture button in the middle, "Sketch" and "Text" on the right. In video mode the "Video" item reads "Photo" on iOS and "Camera" on Android.
* An info button exists in both layouts but is hidden.

## Inputs

| Field        | Type                   | Required | Default | Rules and messages                                                                                                                                                                 |
| ------------ | ---------------------- | -------- | ------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Mode         | photo or video         | yes      | photo   | Switching to video needs the microphone (see Actions)                                                                                                                              |
| Flash        | auto, on, off          | no       | auto    | Hidden for the front camera and in video mode                                                                                                                                      |
| Camera       | rear or front          | no       | rear    | Double-tapping the preview also switches                                                                                                                                           |
| Zoom         | pinch                  | no       | none    | iOS also focuses where the user taps                                                                                                                                               |
| Gallery item | one photo or one video | no       | none    | Videos up to 40 MB: iOS "Snapfix allow video size up to 40 MB. Please choose video up to 40 MB.", Android "Snapfix allows video size up to 40 MB. Please choose video up to 40 MB" |

A new task takes one photo or one video. Picking several items (up to 30) only works when adding media to an existing task.

## Actions

| Action                       | Who                                     | What happens                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     | API  |
| ---------------------------- | --------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---- |
| Capture, photo mode          | anyone here                             | Takes the photo and opens [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md) with it                                                                                                                                                                                                                                                                                                                                                                                                                                  | none |
| Capture, video mode          | anyone here                             | First tap starts, second tap stops; recording stops by itself after 60 seconds. iOS records 640×480 and converts it to MP4 behind "Please Wait..."; Android records SD quality. Then [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md) opens with the first frame                                                                                                                                                                                                                                                    | none |
| "Video" / "Photo" ("Camera") | anyone here                             | Switches mode. iOS asks for the microphone the first time; when it is refused, the app still switches and videos have no sound. Android requires the microphone; a refusal shows "To record a video, allow Snapfix to access your device's microphone. Tap on Go to settings > permission and allow microphone permission." with "Go to settings" and "Not now"                                                                                                                                                                                                  | none |
| "Gallery"                    | anyone here, unless the group blocks it | Opens the picker for one photo or video, then [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md). Android first crops landscape photos, and landscape video thumbnails, to a square. When the camera was opened inside a group with the setting `fBlockGalleryPhoto` on ("Block Photos from Gallery" in iOS group settings), the item looks disabled and a tap shows "This group does not allow users to add photos from the gallery. Please contact the Admin user of this group." From Home the block never applies | none |
| "Sketch"                     | anyone here                             | Opens [Text or sketch task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/text-task.md) with a blank drawing canvas                                                                                                                                                                                                                                                                                                                                                                                                                                   | none |
| "Text"                       | anyone here                             | Opens [Text or sketch task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/text-task.md) with the text lines                                                                                                                                                                                                                                                                                                                                                                                                                                           | none |
| Flash                        | anyone here                             | Cycles auto, on, off                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             | none |
| Switch camera                | anyone here                             | Rear to front and back; disabled while recording                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 | none |
| Scan                         | anyone here                             | Leaves the camera and opens the asset [Code scanner](https://docs.snapfix.com/how-the-apps-work/screens/assets/code-scanner.md) (iOS through the Plan tab's asset registers)                                                                                                                                                                                                                                                                                                                                                                                     | none |
| Close                        | anyone here                             | Leaves the camera; nothing is kept                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               | none |

Nothing is saved or sent from this screen. The task is created at the end of the flow ([Add task to a group](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md), or the group screen when started inside a group).

## States

* **Loading:** the preview starts when the screen appears. iOS shows "Please Wait..." while it converts a recorded video or copies a gallery video; Android shows "Please wait..." while it prepares a gallery photo.
* **Empty:** none.
* **Error:** Android shows "Error setting up camera: " with the system reason when the camera cannot start, "Unable to process image" when a photo cannot be saved, and "Something went wrong. Please try again." when a gallery item cannot be read. A failed video leaves the screen stuck on both platforms.
* **No permission:** camera and location, see [Before the camera opens](#before-the-camera-opens); microphone, see the "Video" action. Photos: Android uses the system photo picker, which needs no permission. iOS asks the first time ("Gallery photos will be used when you want a photo associated with a task or add a photo to a message."); when access was refused, a tap on "Gallery" shows "IMPORTANT", "To save tasks and message image to gallery", "GO TO SETTINGS" and "Cancel". Shared permission prompts: [Shared behavior](https://docs.snapfix.com/how-the-apps-work/shared.md).
* **Offline (mobile):** works fully offline; photos and videos stay on the phone until the task is uploaded ([Saving the task](https://docs.snapfix.com/how-the-apps-work/screens/tasks/pick-group.md#saving-the-task)).

## Dialogs and sheets

* **Gallery picker:** iOS uses its own picker (photos and videos, one item for a new task; videos over 40 MB cannot be selected). Android uses the system photo picker for one photo or video.
* **Square crop (Android):** opens for landscape gallery photos and landscape gallery video thumbnails, at a fixed 1:1 ratio with guidelines. Cancelling it returns to the camera.
* **Permission alerts:** listed under [Before the camera opens](#before-the-camera-opens) and the "Video" action.

## Platform differences

* iOS checks location and camera before opening; Android also requires the microphone, and storage on older Android, before the camera opens.
* The mode label reads "Photo" on iOS and "Camera" on Android while in video mode.
* iOS converts camera videos to 640×480 MP4; gallery videos keep their original file on both platforms. Android records camera video at SD quality.
* Android crops landscape gallery photos to a square before editing; on iOS cropping is optional on [Photo edit and name](https://docs.snapfix.com/how-the-apps-work/screens/tasks/photo-edit.md).
* Only iOS has the home-screen quick action.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.snapfix.com/how-the-apps-work/screens/tasks/camera.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
