@firebolt-js/manage-sdk
Version:
The Firebolt Manage JS SDK
3,889 lines (2,848 loc) • 87 kB
Markdown
---
title: ClosedCaptions
---
# ClosedCaptions Module
---
Version ClosedCaptions 1.5.0
## Table of Contents
- [Table of Contents](#table-of-contents)
- [Usage](#usage)
- [Overview](#overview)
- [Methods](#methods)
- [backgroundColor](#backgroundcolor)
- [backgroundOpacity](#backgroundopacity)
- [enabled](#enabled)
- [fontColor](#fontcolor)
- [fontEdge](#fontedge)
- [fontEdgeColor](#fontedgecolor)
- [fontFamily](#fontfamily)
- [fontOpacity](#fontopacity)
- [fontSize](#fontsize)
- [listen](#listen)
- [once](#once)
- [preferredLanguages](#preferredlanguages)
- [textAlign](#textalign)
- [textAlignVertical](#textalignvertical)
- [windowColor](#windowcolor)
- [windowOpacity](#windowopacity)
- [Events](#events)
- [backgroundColorChanged](#backgroundcolorchanged)
- [backgroundOpacityChanged](#backgroundopacitychanged)
- [enabledChanged](#enabledchanged)
- [fontColorChanged](#fontcolorchanged)
- [fontEdgeChanged](#fontedgechanged)
- [fontEdgeColorChanged](#fontedgecolorchanged)
- [fontFamilyChanged](#fontfamilychanged)
- [fontOpacityChanged](#fontopacitychanged)
- [fontSizeChanged](#fontsizechanged)
- [preferredLanguagesChanged](#preferredlanguageschanged)
- [textAlignChanged](#textalignchanged)
- [textAlignVerticalChanged](#textalignverticalchanged)
- [windowColorChanged](#windowcolorchanged)
- [windowOpacityChanged](#windowopacitychanged)
- [Private Events](#private-events)<details ontoggle="document.getElementById('private-events-details').open=this.open"><summary>Show</summary>
- [backgroundOpacityChanged](#backgroundopacitychanged-1)
- [enabledChanged](#enabledchanged-1)
- [fontColorChanged](#fontcolorchanged-1)
- [fontEdgeChanged](#fontedgechanged-1)
- [fontEdgeColorChanged](#fontedgecolorchanged-1)
- [fontFamilyChanged](#fontfamilychanged-1)
- [fontOpacityChanged](#fontopacitychanged-1)
- [fontSizeChanged](#fontsizechanged-1)
- [preferredLanguagesChanged](#preferredlanguageschanged-1)
- [textAlignChanged](#textalignchanged-1)
- [textAlignVerticalChanged](#textalignverticalchanged-1)
- [windowColorChanged](#windowcolorchanged-1)
- [windowOpacityChanged](#windowopacitychanged-1)
</details>
- [Types](#types)
## Usage
To use the ClosedCaptions module, you can import it into your project from the Firebolt SDK:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
```
## Overview
A module for managing closed-captions Settings.
## Methods
### backgroundColor
The preferred background color for displaying closed-captions, .
To get the value of `backgroundColor` call the method like this:
```typescript
function backgroundColor(): Promise<Color>
```
Promise resolution:
[Color](../Accessibility/schemas/#Color)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.backgroundColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.backgroundColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.backgroundColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `backgroundColor` call the method like this:
```typescript
function backgroundColor(value: Color): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ------------------------------------------ | -------- | ----------- |
| `value` | [`Color`](../Accessibility/schemas/#Color) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundColor('#000000')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundColor",
"params": {
"value": "#000000"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundColor('#ffffff')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundColor",
"params": {
"value": "#ffffff"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundColor()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundColor",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function backgroundColor(callback: (value) => Color): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### backgroundOpacity
The preferred opacity for displaying closed-captions backgrounds.
To get the value of `backgroundOpacity` call the method like this:
```typescript
function backgroundOpacity(): Promise<Opacity>
```
Promise resolution:
[Opacity](../Accessibility/schemas/#Opacity)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.backgroundOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 99
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.backgroundOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 100
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.backgroundOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.backgroundOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `backgroundOpacity` call the method like this:
```typescript
function backgroundOpacity(value: Opacity): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ---------------------------------------------- | -------- | ----------- |
| `value` | [`Opacity`](../Accessibility/schemas/#Opacity) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundOpacity(99)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundOpacity",
"params": {
"value": 99
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundOpacity(100)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundOpacity",
"params": {
"value": 100
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.backgroundOpacity()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setBackgroundOpacity",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function backgroundOpacity(callback: (value) => Opacity): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 99
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 100
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await backgroundOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onBackgroundOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### enabled
Whether or not closed-captions are enabled.
To get the value of `enabled` call the method like this:
```typescript
function enabled(): Promise<boolean>
```
Promise resolution:
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let enabled = await ClosedCaptions.enabled()
console.log(enabled)
```
Value of `enabled`:
```javascript
true
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.enabled",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let enabled = await ClosedCaptions.enabled()
console.log(enabled)
```
Value of `enabled`:
```javascript
true
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.enabled",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": false
}
```
</details>
---
To set the value of `enabled` call the method like this:
```typescript
function enabled(value: boolean): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | --------- | -------- | ----------- |
| `value` | `boolean` | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.enabled(true)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setEnabled",
"params": {
"value": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.enabled(false)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setEnabled",
"params": {
"value": false
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function enabled(callback: (value) => boolean): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await enabled((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `enabled`:
```javascript
true
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onEnabledChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": true
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await enabled((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `enabled`:
```javascript
true
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onEnabledChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": false
}
```
</details>
---
### fontColor
The preferred font color for displaying closed-captions.
To get the value of `fontColor` call the method like this:
```typescript
function fontColor(): Promise<Color>
```
Promise resolution:
[Color](../Accessibility/schemas/#Color)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontColor()
console.log(color)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontColor()
console.log(color)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontColor()
console.log(color)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontColor` call the method like this:
```typescript
function fontColor(value: Color): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ------------------------------------------ | -------- | ----------- |
| `value` | [`Color`](../Accessibility/schemas/#Color) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontColor('#ffffff')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontColor",
"params": {
"value": "#ffffff"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontColor('#000000')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontColor",
"params": {
"value": "#000000"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontColor()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontColor",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontColor(callback: (value) => Color): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#ffffff'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### fontEdge
The preferred font edge style for displaying closed-captions.
To get the value of `fontEdge` call the method like this:
```typescript
function fontEdge(): Promise<FontEdge>
```
Promise resolution:
[FontEdge](../Accessibility/schemas/#FontEdge)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let edge = await ClosedCaptions.fontEdge()
console.log(edge)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdge",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "none"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let edge = await ClosedCaptions.fontEdge()
console.log(edge)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdge",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "uniform"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let edge = await ClosedCaptions.fontEdge()
console.log(edge)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdge",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontEdge` call the method like this:
```typescript
function fontEdge(value: FontEdge): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ------------------------------------------------ | -------- | ----------- |
| `value` | [`FontEdge`](../Accessibility/schemas/#FontEdge) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdge('none')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdge",
"params": {
"value": "none"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdge('uniform')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdge",
"params": {
"value": "uniform"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdge()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdge",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontEdge(callback: (value) => FontEdge): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdge((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "none"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdge((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "uniform"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdge((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `edge`:
```javascript
'none'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### fontEdgeColor
The preferred font edge color for displaying closed-captions.
To get the value of `fontEdgeColor` call the method like this:
```typescript
function fontEdgeColor(): Promise<Color>
```
Promise resolution:
[Color](../Accessibility/schemas/#Color)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontEdgeColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdgeColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontEdgeColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdgeColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let color = await ClosedCaptions.fontEdgeColor()
console.log(color)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontEdgeColor",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontEdgeColor` call the method like this:
```typescript
function fontEdgeColor(value: Color): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ------------------------------------------ | -------- | ----------- |
| `value` | [`Color`](../Accessibility/schemas/#Color) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdgeColor('#000000')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdgeColor",
"params": {
"value": "#000000"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdgeColor('#ffffff')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdgeColor",
"params": {
"value": "#ffffff"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontEdgeColor()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontEdgeColor",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontEdgeColor(callback: (value) => Color): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdgeColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#000000"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdgeColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "#ffffff"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontEdgeColor((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `color`:
```javascript
'#000000'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontEdgeColorChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### fontFamily
The preferred font family for displaying closed-captions.
To get the value of `fontFamily` call the method like this:
```typescript
function fontFamily(): Promise<FontFamily>
```
Promise resolution:
[FontFamily](../Accessibility/schemas/#FontFamily)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let family = await ClosedCaptions.fontFamily()
console.log(family)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontFamily",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "monospaced_sanserif"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let family = await ClosedCaptions.fontFamily()
console.log(family)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontFamily",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "cursive"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let family = await ClosedCaptions.fontFamily()
console.log(family)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontFamily",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontFamily` call the method like this:
```typescript
function fontFamily(value: FontFamily): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ---------------------------------------------------- | -------- | ----------- |
| `value` | [`FontFamily`](../Accessibility/schemas/#FontFamily) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontFamily('monospaced_sanserif')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontFamily",
"params": {
"value": "monospaced_sanserif"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontFamily('cursive')
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontFamily",
"params": {
"value": "cursive"
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontFamily()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontFamily",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontFamily(callback: (value) => FontFamily): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontFamily((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontFamilyChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "monospaced_sanserif"
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontFamily((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontFamilyChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": "cursive"
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontFamily((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `family`:
```javascript
'monospaced_sanserif'
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontFamilyChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### fontOpacity
The preferred opacity for displaying closed-captions characters.
To get the value of `fontOpacity` call the method like this:
```typescript
function fontOpacity(): Promise<Opacity>
```
Promise resolution:
[Opacity](../Accessibility/schemas/#Opacity)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.fontOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 99
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.fontOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 100
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let opacity = await ClosedCaptions.fontOpacity()
console.log(opacity)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontOpacity",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontOpacity` call the method like this:
```typescript
function fontOpacity(value: Opacity): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ---------------------------------------------- | -------- | ----------- |
| `value` | [`Opacity`](../Accessibility/schemas/#Opacity) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontOpacity(99)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontOpacity",
"params": {
"value": 99
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontOpacity(100)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontOpacity",
"params": {
"value": 100
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontOpacity()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontOpacity",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontOpacity(callback: (value) => Opacity): Promise<number>
```
Promise resolution:
```
number
```
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 99
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 100
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let listenerId = await fontOpacity((value) => {
console.log(value)
})
console.log(listenerId)
```
Value of `opacity`:
```javascript
99
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.onFontOpacityChanged",
"params": {
"listen": true
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
### fontSize
The preferred font size for displaying closed-captions.
To get the value of `fontSize` call the method like this:
```typescript
function fontSize(): Promise<FontSize>
```
Promise resolution:
[FontSize](../Accessibility/schemas/#FontSize)
Capabilities:
| Role | Capability |
| ---- | ---------------------------------------------------- |
| uses | xrn:firebolt:capability:accessibility:closedcaptions |
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let size = await ClosedCaptions.fontSize()
console.log(size)
```
Value of `size`:
```javascript
1
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontSize",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 1
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let size = await ClosedCaptions.fontSize()
console.log(size)
```
Value of `size`:
```javascript
1
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontSize",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": 1
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let size = await ClosedCaptions.fontSize()
console.log(size)
```
Value of `size`:
```javascript
1
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.fontSize",
"params": {}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To set the value of `fontSize` call the method like this:
```typescript
function fontSize(value: FontSize): Promise<void>
```
Parameters:
| Param | Type | Required | Description |
| ------- | ------------------------------------------------ | -------- | ----------- |
| `value` | [`FontSize`](../Accessibility/schemas/#FontSize) | true | |
Promise resolution:
#### Examples
Default example #1
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontSize(1)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontSize",
"params": {
"value": 1
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #2
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontSize(1)
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontSize",
"params": {
"value": 1
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
Default example #3
JavaScript:
```javascript
import { ClosedCaptions } from '@firebolt-js/manage-sdk'
let result = await ClosedCaptions.fontSize()
console.log(result)
```
Value of `result`:
```javascript
null
```
<details>
<summary>JSON-RPC:</summary>
Request:
```json
{
"jsonrpc": "2.0",
"id": 1,
"method": "ClosedCaptions.setFontSize",
"params": {
"value": null
}
}
```
Response:
```json
{
"jsonrpc": "2.0",
"id": 1,
"result": null
}
```
</details>
---
To subscribe to notifications when the value changes, call the method like this:
```typescript
function fontSize(callback: (value) => FontSize): Promise<number>
```
Promise resolution:
```
number
```
#### Ex