# GraffitiAudioRecorder
Class Inherits GraffitiWebControl
## About
Allow your users to shoot and upload audio files without a lot of hassle!
## Compatibility
### Framework API Version
| 1.0 | 2.0 |
| :---: | :---: |
| True | True |
### Web
| 32-Bit | 64-Bit |
| :---: | :---: |
| True | True |
## Enumerations
| Name | Value | Description |
| --- | :---: | --- |
| RecordingStates | Idle <br> StreamActive <br> Recording <br> Paused | Supporting recording states. |
## Event Definitions
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| DataAvailable | file as WebFile | (None) | Raised when new data has arrived. |
| DevicesAvailable | (None) | (None) | Raised when the list of supported devices has been received from the user's browser. |
| Error | errorMessage as String | (None) | Raised when an error occurs within the user's browser. |
| MouseEnter | (None) | (None) | |
| MouseExit | (None) | (None) | |
| Open | (None) | (None) | |
| Shown | (None) | (None) | |
| StateChanged | (None) | (None) | Raised when the State of the recorder has changed. |
## Methods
| Name | Parameters | Return Type | Description |
| --- | :---: | :---: | --- |
| BeginRecording | (None) | (None) | Begins a recording session. If SourceAudio and SourceVideo devices are not supplied, the first devices returned will be used. If the stream has not been started, it will be. |
| Devices | (None) | GraffitiMediaDevice | Returns an array of GraffitiMediaDevice that represents the Audio and Video devices accessible to the user's browser. |
| EndRecording | (None) | (None) | Stops the recording session, does not stop the stream. |
| PauseRecording | (None) | (None) | Pauses the recording session, does not pause the stream. |
| ResumeRecording | (None) | (None) | Resumes the recording session if paused. |
| State | (None) | RecordingStates | Returns the current state of the component. |
| Supported | (None) | Boolean | Returns whether the user's browser supports the relevant JavaScript APIs and has allowed access. |
## Properties
| Name | Type | Default Value | Description |
| --- | :---: | :---: | --- |
| SourceAudio | GraffitiMediaDevice | Nil | The audio device to use for recording sessions. |
| SourceVideo | GraffitiMediaDevice | Nil | The video device to use for recording sessions. |