---
title: "registerGlobalMetaParameter(metaParameterDefinition:)"
framework: phase
role: symbol
role_heading: Instance Method
path: "phase/phaseassetregistry/registerglobalmetaparameter(metaparameterdefinition:)"
---

# registerGlobalMetaParameter(metaParameterDefinition:)

Registers a global metaparameter with the asset registry.

## Declaration

```swift
func registerGlobalMetaParameter(metaParameterDefinition: PHASEMetaParameterDefinition) throws -> PHASEGlobalMetaParameterAsset
```

## Parameters

- `metaParameterDefinition`: A single parameter that controls the value of multiple parameters.

## Return Value

Return Value A global metaparameter object. If an error occurs, the function returns nil.

## Discussion

Discussion Global metaparameters attach to any number of sound event assets. When an app adjusts a global metaparameter at runtime, the change propagates immediately to all the attached sound events. note: Although you register a global metaparameter definition (PHASEMetaParameterDefinition) with this function, you receive a global metaparameter instance (PHASEMetaParameter) when you access the parameter by its identifier using the globalMetaParameters dictionary.

## See Also

### Registering Global Metaparameters

- [globalMetaParameters](phase/phaseassetregistry/globalmetaparameters.md)