Interface ExpressAsOptions

Configuration options for express-as elements (Azure-specific).

Controls emotional expression and speaking styles for neural voices that support these features. Allows for nuanced emotional delivery and role-playing scenarios.

Example

// Happy expression
const happy: ExpressAsOptions = {
  style: 'cheerful',
  styledegree: '2'  // Double intensity
};

// Child narrator
const childNarrator: ExpressAsOptions = {
  style: 'narration-relaxed',
  role: 'Girl'
};

See

https://docs.microsoft.com/azure/cognitive-services/speech-service/speech-synthesis-markup#express-as-element Express-As Documentation

interface ExpressAsOptions {
    role?: ExpressAsRole;
    style: ExpressAsStyle;
    styledegree?: string;
}

Index

Properties

role? style styledegree?

Properties

`Optional`role

role?: ExpressAsRole

Age and gender role for voice modification.

Simulates different speaker characteristics. Only supported by certain voices.

Example

"Girl"

Example

"OlderAdultMale"

Example

"YoungAdultFemale"

See

ExpressAsRole type for full list

style

style: ExpressAsStyle

Emotional or speaking style to apply. (Required)

The available styles depend on the voice being used. Common categories include emotions (cheerful, sad, angry), professional styles (newscast, customerservice), and special effects (whispering, shouting).

Example

"cheerful"

Example

"newscast-formal"

Example

"whispering"

See

ExpressAsStyle type for full list

`Optional`styledegree

styledegree?: string

Intensity of the style expression.

Controls how strongly the style is applied. Range: "0.01" (minimal) to "2" (double intensity)

Default Value

"1"

Example

"0.5" - Half intensity

Example

"1.5" - 50% more intense

Example

"2" - Maximum intensity

Interface ExpressAsOptions

Example

See

Index

Properties

Properties

`Optional`role

Example

Example

Example

See

style

Example

Example

Example

See

`Optional`styledegree

Default Value

Example

Example

Example

Settings

On This Page

Interface ExpressAsOptions

Example

See

Index

Properties

Properties

Optionalrole

Example

Example

Example

See

style

Example

Example

Example

See

Optionalstyledegree

Default Value

Example

Example

Example

Settings

On This Page

`Optional`role

`Optional`styledegree