Recorded Announcement Download Initiate 0x0052

SwitchKit Name

RecAnnDownloadInit

Type

EXS API and SwitchKit API message

Description

This is the first message sent by the host to initiate the downloading of a recorded announcement to a VRAS SIMM. If multiple SIMMs are to have the same announcement, each SIMM must be downloaded separately. If you try to use this message for the DSP Series 2 card, the Matrix Controller Series 3 card NACKs it.

For SwitchKit

This message downloads a voice file to a VRAS board on the Excel platform. The format and encoding correspond to the arguments of the RecAnnDownloadInitiate message. The slot and SIMM must refer to a valid VRAS SIMM, and the ID is used to reference this prompt from future messages. If the voice file is already present on the SIMM, the SwitchManager bypasses the downloading. If there is another voice file with that ID already on the SIMM, then the configuration fails. The VRAS SIMM must be cleared with a RecAnnDelete before the new voice file is downloaded.

Sent by

Host (SwitchManager for SwitchKit)

Example Message (Socket Log Output for SwitchKit)

See Recorded Announcement Download 0x0053 for the socket log output/example of the Recorded Announcement Download Initiate message and a Recorded Announcement Download message together.

SwitchKit Code

Configuration

RecordedAnnouncement(

file = quoted string,

slot = integer,

SIMM = integer,

id = integer,

format = integer,

encoding = integer

);

C Structure

typedef struct {

UBYTE Slot;

UBYTE SIMM;

unsigned short ID;

int Size;

int Checksum;

UBYTE Format;

UBYTE Encoding;

} XL_RecAnnDownloadInit;

C++ Class

class XLC_RecAnnDownloadInit : public XLC_OutboundMessage {

public:

UBYTE getSlot() const;

void setSlot(UBYTE x);

UBYTE getSIMM() const;

void setSIMM(UBYTE x);

unsigned short getID() const;

void setID(unsigned short x);

int getSize() const;

void setSize(int x);

int getChecksum() const;

void setChecksum(int x);

UBYTE getFormat() const;

void setFormat(UBYTE x);

UBYTE getEncoding() const;

void setEncoding(UBYTE x);

};

EXS API Hex Format