Releasing the Oracle Radio WebSocket Talk Floor
Send a RELEASE_TALK message to release a talk token and make the Radio channel available.
Permissions and Prerequisites
The following permissions and prerequisites apply to this operation.
| Requirement | Value |
|---|---|
| Authentication | Complete the supported authentication path for the client before sending this operation. See authentication. |
| Radio permission | No additional permission is required to release your own talk token. The radio.talk.release permission allows an authorized user to override ownership when releasing a token. |
| Channel access | Specify the channel controlled by the talk token. |
| Session state | The WebSocket connection must be open. End an active audio transmission, and then promptly supply its talk token and channel. |
Note
Sending
Sending
END ends the audio transmission but doesn't release a still-valid talk token. Always release the token when the client is finished transmitting.Request
Send the RELEASE_TALK message as a JSON text message.
| Name | Data type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
type | string | Yes | None | Must be RELEASE_TALK. | Identifies the talk-floor release operation. |
token | string | Yes | None | UUID. | Talk token to release. |
channel | string | No | default | Channel name. | Channel controlled by the talk token. |
{
"type": "RELEASE_TALK",
"token": "550e8400-e29b-41d4-a716-446655440000",
"channel": "operations"
}Responses
The following table lists the messages the client can receive and explains their purpose.
| Message type | Kind | Description |
|---|---|---|
RELEASED | Direct response | Confirms that the talk token was released. |
CHANNEL_OPEN | Asynchronous event | Notifies channel subscribers that the channel is idle. |
TOKEN_INVALID | Related token event | Can be received while sending binary audio if no current talk token controls the transmission. It isn't the direct response to RELEASE_TALK. |
ERROR | Error | Indicates that the token is missing, invalid, or expired; the channel is invalid; the requester isn't allowed to release the token; or the request couldn't be processed. |
RELEASED Response
The following table describes the response properties, their data types, and whether they are required.
| Name | Data type | Required | Description |
|---|---|---|---|
type | string | Yes | Response type. The value is RELEASED. |
{
"type": "RELEASED"
}