# captureAudio

## Description

Activates the voice recording UI to capture audio.

## Input / Parameter

N/A

## Output

| Description                        | Output Type |
| ---------------------------------- | ----------- |
| Returns the formatted information. | Object      |

### Object

| Key     | Description                                                             | Output Type |
| ------- | ----------------------------------------------------------------------- | ----------- |
| success | Boolean value to denote whether the function was executed successfully. | Text        |
| message | The message to print.                                                   | Text        |
| data    | Any additional message or data to print.                                | Text        |

## Callback

### callback

The function to be executed when the voice recording is generated successfully.

### errorCallback

The function to be executed when the voice recording is not generated successfully.

## Example

In this example, we will create a voice recording using a mobile device and print the audio file path in the console.

### Steps

1. Drag a button component to a page in the mobile designer. Select the event `press` and drag the `Device.captureAudio` function to the event flow.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-558acc812d3fd270b6259bf69facbf6ae132bcab%2FcaptureAudio-step-1.png?alt=media)
2. Drag the function to be executed if the audio recording is successful or failed to the node below the function. In this example, we are using the `Log.write` function. Fill in the parameters of the function.

   ![](https://399701567-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwmJ1RKjM2uNFaL6fO3Xu%2Fuploads%2Fgit-blob-e08b250e1fabaae210e427d4c5a18db4cf77f2cd%2FcaptureAudio-step-2.png?alt=media)

### Result

1. The path of the audio file will be shown in the console.