-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #115 from GetStream/update-call-types-page
Update call types page
- Loading branch information
Showing
3 changed files
with
142 additions
and
129 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,23 @@ | ||
- `join-call` | ||
- `read-call` | ||
- `create-call` | ||
- `join-ended-call` | ||
- `join-backstage` | ||
- `update-call` | ||
- `update-call-settings` | ||
- `screenshare` | ||
- `send-video` | ||
- `send-audio` | ||
- `start-record-call` | ||
- `stop-record-call` | ||
- `start-broadcast-call` | ||
- `stop-broadcast-call` | ||
- `end-call` | ||
- `mute-users` | ||
- `update-call-permissions` | ||
- `block-users` | ||
- `create-reaction` | ||
- `pin-for-everyone` | ||
- `remove-call-member` | ||
- `start-transcription-call` | ||
- `stop-transcription-call` |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,113 @@ | ||
### Audio | ||
|
||
| Setting Name | Type | Description | | ||
| -------------------------- | ------------------------------ | --------------------------------------------------------------------------------------- | | ||
| `access_request_enabled` | Boolean | When `true` users that do not have permission to this feature can request access for it | | ||
| `opus_dtx_enabled` | Boolean | When `true` OPUS DTX is enabled | | ||
| `redundant_coding_enabled` | Boolean | When `true` redundant audio transmission is enabled | | ||
| `mic_default_on` | Boolean | When `true` the user will join with the microphone enabled by default | | ||
| `speaker_default_on` | Boolean | When `true` the user will join with the audio turned on by default | | ||
| `default_device` | String `speaker` or `earpiece` | The default audio device to use | | ||
|
||
### Backstage | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | ------- | -------------------------------------------------------------------------------------------------------------------------------- | | ||
| `enabled` | Boolean | When backstage is enabled, calls will be in backstage mode when created and can be joined by users only after `goLive` is called | | ||
|
||
### Video | ||
|
||
| Setting Name | Type | Description | | ||
| ------------------------ | ------------------------------------ | --------------------------------------------------------------------------------------- | | ||
| `enabled` | Boolean | Defines whether video is enabled for the call | | ||
| `access_request_enabled` | Boolean | When `true` users that do not have permission to this feature can request access for it | | ||
| `camera_default_on` | Boolean | When `true`, the camera will be turned on when joining the call | | ||
| `camera_facing` | String `front`, `back` or `external` | When applicable, the camera that should be used by default | | ||
| `target_resolution` | Target Resolution Object | The ideal resolution that video publishers should send | | ||
|
||
The target resolution object is an advanced resolution. Changing this from the default values can lead to poor performance. This is how you define it: | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | ------ | -------------------- | | ||
| `width` | Number | The width in pixels | | ||
| `height` | Number | The height in pixels | | ||
| `bitrate` | Number | The bitrate | | ||
|
||
### Screensharing | ||
|
||
| Setting Name | Type | Description | | ||
| ------------------------ | ------- | --------------------------------------------------------------------------------------- | | ||
| `enabled` | Boolean | Defines whether screensharing is enabled | | ||
| `access_request_enabled` | Boolean | When `true` users that do not have permission to this feature can request access for it | | ||
|
||
### Recording | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | ----------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ||
| `mode` | String `available`, `disabled` or `auto-on` | `available` → recording can be requested <br />`disabled` → recording is disabled <br />`auto-on` → recording starts and stops automatically when one or multiple users join the call | | ||
| `quality` | String `audio-only`, `360p`, `480p`, `720p`, `1080p`, `1440p` | Defines the resolution of the recording | | ||
| `audio_only` | `boolean` | If `true` the recordings will only contain audio | | ||
| `layout` | object, for more information see the [API docs](https://getstream.io/video/docs/api/recording/calls/#recording-layouts) | Configuration options for the recording application | | ||
|
||
### Broadcasting | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | --------------------- | --------------------------------------- | | ||
| `enabled` | Boolean | Defines whether broadcasting is enabled | | ||
| `hls` | HLS Settings (object) | Settings for HLS broadcasting | | ||
|
||
### HLS Settings | ||
|
||
| Setting Name | Type | Description | | ||
| ---------------- | ------------------------------------------------------------- | ------------------------------------------------------------------- | | ||
| `enabled` | Boolean | Defines whether HLS is enabled or not | | ||
| `auto_on` | Boolean | When `true` HLS streaming will start as soon as users join the call | | ||
| `quality_tracks` | String `audio-only`, `360p`, `480p`, `720p`, `1080p`, `1440p` | The tracks to publish for the HLS stream (up to three tracks) | | ||
|
||
### Geofencing | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------- | | ||
| `names` | List of one or more of these strings `european_union`, `iran_north_korea_syria_exclusion`, `china_exclusion`, `russia_exclusion`, `belarus_exclusion`, `india`, `united_states`, `canada` | The list of geofences that are used for the calls of these type | | ||
|
||
More information can be found in the [API docs](https://getstream.io/video/docs/api/call_types/geofencing/). | ||
|
||
### Transcription | ||
|
||
| Setting Name | Type | Description | | ||
| --------------------- | ------------------------------------------- | ------------------- | | ||
| `mode` | String `available`, `disabled` or `auto-on` | Not implemented yet | | ||
| `closed_caption_mode` | String | Not implemented yet | | ||
|
||
### Ringing | ||
|
||
| Setting Name | Type | Description | | ||
| -------------------------- | ------ | --------------------------------------------------------------------------------------------------- | | ||
| `incoming_call_timeout_ms` | Number | Defines how long the SDK should display the incoming call screen before discarding the call (in ms) | | ||
| `auto_cancel_timeout_ms` | Number | Defines how long the caller should wait for others to accept the call before canceling (in ms) | | ||
|
||
### Push Notifications Settings | ||
|
||
| Setting Name | Type | Description | | ||
| ------------------- | ---------------------------------- | ----------------------------------------------------------- | | ||
| `enabled` | Boolean | | | ||
| `call_live_started` | Event Notification Settings Object | The notification settings used for call_live_started events | | ||
| `session_started` | Event Notification Settings Object | The notification settings used for session_started events | | ||
| `call_notification` | Event Notification Settings Object | The notification settings used for call_notification events | | ||
| `call_ring` | Event Notification Settings Object | The notification settings used for call_ring events | | ||
|
||
In order to define the _event notification settings object_, here is the structure of how it should look: | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | -------------------- | ---------------------------------- | | ||
| `enabled` | Boolean | Whether this object is enabled | | ||
| `apns` | APNS Settings Object | The settings for APN notifications | | ||
|
||
### APNS Settings Object | ||
|
||
Remote notifications can only be customized if your application implements a Notification Service Extension. For simple customizations, you can change the title and body fields at the call type level. Both title and body fields are handlebars templates with call and user objects available in their scope. | ||
|
||
| Setting Name | Type | Description | | ||
| ------------ | -------- | ----------------------------------------------------------- | | ||
| title | Template | The string template for the title field of the notification | | ||
| body | Template | The string template for the body field of the notification | |
Oops, something went wrong.