1. Configuration Guide
  2. Local Media Playback
  3. Configuring Local Media Playback with SPL
  4. ACLI Configuration and Examples - SPL Method
  5. Set Playback Options on Realms, Session Agents, and SIP Interfaces

Set Playback Options on Realms, Session Agents, and SIP Interfaces

To set playback options for realms, session agents, and SIP interfaces on the Oracle Communications Session Border Controller (OCSBC), you can set the spl-options parameter under each of those objects in the ACLI. The spl-options parameter allows you to set the following options:

  • playback-on-183-to-originator—Playback enabled upon the receipt of a 183 Session Progress destined for the originator and stops when a either a 200-299 or 400-699 final response is sent.
  • playback-on-183-from-terminator—Playback enabled upon the receipt of a 183 Session Progress response is received from the terminator and stops when a 200-299 or 400-699 final response is received.
  • playback-on-refer—Playback enabled for the caller being transferred when the OCSBC receives a REFER message that is locally terminated (i.e., processed on the OCSBC on REFER completion).
  • playback-on-header—Starts or stops playback based on the presence of the P-Acme-Playback header and its definitions.

Note:

The OCSBC supports a maximum of 100 simultaneous playbacks.

With each of these options, you set the name of the playback configuration you want to use for the associated scenario. Except with playback-on-header, if there is one file to play, the OCSBC loops it continuously until a stop event occurs. If multiple media files can be used for the same events, the OCSBC queues them in the order you specify in your configuration and plays them consecutively until a stop event occurs. For playback-on-header, you can define how you want playback to work by setting the duration mode in the P-Acme-Playback header to once, continuous, or the amount of time in milliseconds you want the media to play.

The following example shows you how to configure the playback-on-refer SPL option for a session agent. The steps are the same for the spl-options parameter in realms, session agents, and SIP interfaces. Simply set the option you want in the configuration where it needs to be applied.

Procedure
  1. Access the session-agent configuration element. 
    ORACLE# configure terminal
ORACLE(configure)# session-router
ORACLE(session-router)# session-agent
ORACLE(session-agent)
  2. Type spl-options, followed by the option name pre-pending with the plus sign (+). If you do not use the plus sign, the system overwrites any other options that you configured previously. 
    ACMESYSTEM(session-agent)# spl-options +playback-on-refer=media1,media2

    In the previous example, the OCSBC will play media1 and then media2.

  3. Type done and save the configuration.