Platform SDK: Broadcast Architecture |
Announcements sent to ATVEF clients should be formatted as described in the ATVEF specification. Your authoring tool can format announcements by calling methods of the IATVEFAnnouncement interface. This interface exposes a set of accessor functions that your application can call to set the fields of an announcement.
The fields set in the announcement include the IP addresses and ports used to transmit triggers and packages. You can call either ConfigureTriggerTransmission and ConfigureDataTransmission or ConfigureDataAndTriggerTransmission to set these addresses. These addresses must be configured in the announcement object before your application can transmit packages or triggers.
After the announcement has been configured, it should be connected by calling IATVEFSend::Connect. The Connect method gathers all the information set in the announcement and prepares the CSendATVEFInserter or CSendATVEFMulticast object to send transmissions. Note that changing the values set in the announcement fields, changes the information used to connect the object, and implicitly disconnects the object.
After the Connect method has been called, the announcement can be transmitted by calling IATVEFSend::SendAnnouncement. Calling this method does not reset the announcement properties. Because of this, your authoring tool can set the announcement properties once and then call SendAnnouncement as needed to resend the announcement.
The ATVEFSnd.dll library does not provide methods to persist announcement information beyond the life of the Inserter or Multicast object. If your authoring tool requires this functionality, it must implement it.
For more information and sample code, see Creating an Announcement.