Difference between revisions of "PlayAnnouncement"

Latest revision as of 15:24, 28 August 2013

[edit] Capability: Camel

[edit] Usage

This operation is to be used by the gsmSCF and sent to the gsmSRF after Establish Temporary Connection (assist procedure with a second gsmSSF) or a Connect to Resource (no assist) operation. It may be used for inband user interaction with a Mobile Station.

[edit] Expected actions

• On receipt of this operation the gsmSSF performs actions to send the advice of charge information to the indicated Call Party's MS (Mobile Station).

[edit] Invoke parameters

• informationToSend – it's a choice between the following parameters:
  • inbandInfo – specifies the inband information to be sent:
    • messageID – the message to be sent and can be one of the following:
      • elementaryMessageID – indicates a single announcement.
      • text – indicates a text to be sent. The text will be transformed to inband information by the gsmSRF....
      • elementaryMessageIDs – indicates a series of announcements. ..
      • variableMessage – indicates a message with one or more variable parts...
    • numberOfRepetitions – the maximum number of times the message shall be sent to the user.
    • duration – the maximum duration in seconds that the message shall be played. A value of zero indicates endless repetition.
    • interval – indicates interval in seconds between repetitions.
  • tone – indicates a tone to be sent to the user by:
    • toneID – the id of the tone to be sent
    • toneDuration – duration in seconds of the tone to be sent. Zero indicates infinite duration.
• disconnectFromIPForbidden – indicates whether the gsmSRF shall be disconnected from the user when all information has been sent.
• requestAnnouncementComplete - indicates whether a SpecializedResourceReport shall be sent when all information has been sent.
• extensions

[edit] Result parameters

This operation does not expect a result.

[edit] Example

	<component localCID="1" type="Invoke" operationCode="playAnnouncement">
    		<informationToSend>
      		<tone>
        			<toneID>5</toneID>
        			<duration>10</duration>
      		</tone>
    		</informationToSend>
    		<disconnectFromIPForbidden>false</disconnectFromIPForbidden>
    		<requestAnnouncementComplete>true</requestAnnouncementComplete>
  	</component>