setMicrophone - Momentic

Feeds an audio file into the microphone of the simulator, so the app under test hears the audio instead of silence. Use it to test flows like voice input or speech recognition. This command runs only on Momentic-hosted iOS simulators. It is not supported on Android or on local simulators.

Parameters

Parameter	Type	Required	Description
`path`	`string`	Yes	Path to the audio file on the host. May be a local path or a URL.
`once`	`boolean`	No	Play the audio one time instead of looping. Defaults to `false`.
`saveAs`	`string`	No	Variable to store this step’s return value on `env.<name>`.
`retries`	`number`	No	Times to retry the step on failure before failing the test.
`skipped`	`boolean`	No	Skip this step at execution time.

Use a .wav, .mp3, .m4a, .aac, or .caf file.

Examples

Simplified form:

- setMicrophone: ./fixtures/speech.wav

Detailed form, with a single pass instead of a loop:

- setMicrophone:
    path: ./fixtures/speech.wav
    once: true

Setting a new file replaces the one that is playing. Put the step in before to keep one audio input active for the whole test:

before:
  - setMicrophone: ./fixtures/speech.wav
steps:
  - tap: Start recording
  - checkScreenContains: Transcription ready
  - clearMicrophone

⌘I