Recording Controller Connector
This section contains Recording Controller Connector (RCC) proto files.
Notes:
- To download Media Manager proto files, click download Media Manager proto files.
- Default values are determined by the gRPC specification. For more information, go to protocol buffers language guide .
mediamanager/connector/media/recorder_controller_service.proto
RecorderConnectorService
This service allows a Recorder Connector to send call events to Recording Service indicating that a call has started or ended.
gRPC method definitions
| Method Name | Request Type | Response Type | Description |
|---|---|---|---|
| CreateCallEvent | CreateCallEvent Request |
CreateCallEvent Response |
Creates a CallEvent used by Recording Service. |
CreateCallEventRequest
Input message that defines parameters for CallEventNotification.
| Field | Type | Description |
|---|---|---|
| call_id | string | Mandatory. The call identifier used by the recorder to match a recorder command request with the actual call.Call identifier |
| call_event_type | CallEventType | Mandatory. One of the CallEventType enum values must be provided by the Recorder Controller Connector. |
| recorder_controller_connector_info | RecorderControllerConnectorInfo | Mandatory. RecorderControllerConnectorInfo info required by Media Manager to identify to which Recorder a recording command shall be sent to. |
| media_coordination_info | nuance.mediamanager.connector.v1.MediaCoordinationInfo | Optional. MediaCoordinationInfo used by Media Manager to indentify to which Media Connector to send the recording command when present. |
| recording_profile | string | The recording_profile string has the following four parameters that are delimited by a forward slash ("/")* payload_number: The payload type * encoding_name: The encoding name * clock_rate: The clock rate * profile: Optional. Its default value is ‘rtp’. You can set its value as ‘rtp’ or ‘srtp’.and follows RFC3551: https://www.iana.org/assignments/rtp-parameters/rtp-parameters.xhtml Examples: * 0/PCMU/8000: payload type 0, name PCMU, clock rate 8000, profile rtp * 8/PCMA/8000/srtp: payload type 8, name PCMA, clock rate 8000, profile srtp |
CreateCallEventResponse
Output message that defines parameters returned by CallEvent. Included in CallEventNotification.
| Field | Type | Description |
|---|---|---|
| status | nuance.rpc.Status | Mandatory. General operation status. |
RecorderControllerConnectorInfo
Message containing information about the Recording Controller Connector where the call event occurred.
| Field | Type | Description |
|---|---|---|
| connector_session_id | string | Mandatory. Represents the Recorder Connector session id obtained from Connector Manager. |
| address | string | Mandatory. Represents the Recorder Connector address that the Media Connector shall use to sends a recorder command. The address must be in the format of “dns://host:port” or “static://ipv4-address:port” |
| tenant_id | string | Mandatory. The tenant identifier. |
CallEventType
Listing of the recorder operation types.
| Name | Number | Description |
|---|---|---|
| CALL_EVENT_UNSPECIFIED | 0 | Call Event Type was not specified. |
| CALL_STARTED | 1 | Recorder call is established. |
| CALL_ENDED | 2 | Recorder call has ended. |