View source for PlayAnnouncement

{{DISPLAYTITLE:playAnnouncement}}
==Capability: Camel==

==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.

==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).

==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''

==Result parameters==

This operation does not expect a result.

==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>