1. ACLI Configuration Guide
  2. Local Media Playback

21 Local Media Playback

Commonly, ringback is the media playback of a certain tone informing callers that their calls are in progress. In typical deployments, remote endpoints or media servers handle ringback generation, leaving the Oracle® Enterprise Session Border Controller (ESBC) to proxy RTP. You can configure the ESBC becomes the producer for environments where endpoints or media servers do not support ringback generation, or if different ringback is required

When you configure the ESBC to generate ringback locally, you enable it to produce RTP media on a media flow called ringback tone (RBT) from a session-agent, sip-interface or realm-config, using typical precedence when determining which configuration to use if there are overlapping configurations. There are other criteria to determine which configuration to use described herein. These are generally characterized as "closest to the target". Because you can also use this capability for music-on-hold, announcements, interrupting media for notifications and so forth, this ESBC capability is referred to as local medial playback.

The ESBC can produce Local Media Playback using one of two methods:

  • Transcoding based ringback—The ESBC uses local transcoding resources to produce RTP.
  • SPL based ringback—The ESBC generates RTP using SPL resources.

You can only use one method on an ESBC at a time.

There are two components of RBT configuration for both the SPL and transcoding-based methods:
  • Triggers—Specifies when the ESBC plays the media file:
    • Transcoding-based—Configured with the ACLI ringback-trigger parameter
    • SPL—Set as parameters to the spl-option
  • Media—Specifies the local media file that the ESBC plays:
    • Transcoding-based—Configured with the ACLI ringback-file parameter
    • SPL—Configured with ACLI playback-config elements and applied as a parameter to the spl-option

Note:

Transcoding based RBT requires transcoding resources. For example, be sure you have a transcoding core configured on your vSBCs to use this feature.

Additional Configuration Consideration

There are issues you may encounter with RBT generation with respect to compliance with RFC 6337, such as 1-way audio after the 200 OK. If the SDP presented in final 200 OK is not consistent with final 200 OK answer from the end station, this departure from RFC compliance may trigger a rejection of the SDP by the endstation. In such cases, the RBT may continue, but the call will fail.

To alleviate this compliance issue, set the unique-sdp-id option in the media-manager. 

ACMEPACKET(media-manager)# options +unique-sdp-id

If you type the option without the plus sign, you will overwrite any previously configured options. In order to append the new options to the realm configuration’s options list, you must prepend the new option with a plus sign as shown in the previous example.