---
title: "setModules(_:)"
framework: speech
role: symbol
role_heading: Instance Method
path: "speech/speechanalyzer/setmodules(_:)"
---

# setModules(_:)

Adds or removes modules.

## Declaration

```swift
final func setModules(_ newModules: [any SpeechModule]) async throws
```

## Parameters

- `newModules`: A list of modules to include in the analyzer. These modules replace the previous modules, but you may preserve previous modules by including them in the list.

## Discussion

Discussion Modules can be added or removed to the analyzer mid-stream. A newly-added module will immediately begin analysis on new audio input, but it will not have access to already-analyzed audio. However, you may keep a copy of previously-analyzed audio and provide it to a separate analyzer. Modules cannot be reused from a different analyzer. note: There is a limit to the number of active, backing engine instances and models SpeechAnalyzer is allowed to allocate to clients at the same time. An error will be thrown if that limit is reached in order to prevent poor system performance. Several transcriber instances can share the same backing engine instances and models, so long as the transcribers are configured similarly in certain respects. For iOS and visionOS, this roughly translates to two ongoing recognition instances (or two incompatible modules running simultaneously). There is currently no limit on macOS.

## See Also

### Managing modules

- [modules](speech/speechanalyzer/modules.md)