Creating and sending an MMS message directly on the SDK

Two or more SDKs can exchange MMS messages using the -Xinbox and -Xoutbox command line options. Perform this test to see whether a MIDI file can be forwarded in an MMS message or to see how an MMS message appears on this SDK and future SDKs.

By default, each SDK instance creates both an MMS outbox and inbox folder on your computer at:

<SDK installation directory>\bin\Storage\<instance identifier>

The SDK places sent MMS message files into the outbox folder. It also monitors its inbox folder. If an MMS message file appears in the inbox folder, the SDK reads the file, treats it as a received MMS message, and deletes the file.

If you create two SDK instances, you can copy or move an MMS message file from the outbox folder of one instance to the inbox folder of the other, which allows you to simulate sending an MMS message from one instance to the other

To set up a situation where two SDKs share their inboxes and outboxes:

Enter the following command to create an SDK instance that automatically writes message files to box_a and reads message files from box_b:
```
emulator -Xoutbox:c:\box_a -Xinbox:c:\box_b
```
Open a second command window. Enter the following command to create an SDK instance that automatically reads message files from box_a and writes message files to box_b:
```
emulator -Xinbox:c:\box_a -Xoutbox:c:\box_b
```
Perform the following actions to create and send a message on the first SDK instance using the simulated phone menus:
- Navigate to Menu > Messaging > Create Message. Your message view appears. Type the text of the message
- Perform the appropriate action for graphics, video, and/or sound:
  - To insert symbol, navigate to Options > Insert symbol. Select a desired symbol from the list of symbols displayed, the symbol will be inserted in the message.
  - To insert photo, navigate to Options > Insert object > Photos, or you may opt for New Photo to insert a newly captured photo.
  - To insert a new audio or video file, navigate to Options > Insert object > New recording > Video or Voice > Record. The audio or video file will be attached to the message.
  - To insert a pre-existing audio or video file, select Options > Insert object > Open Gallery. Select the audio or video file.
  - To insert a business card, navigate to Options > Insert object > Business card. Select a name from the list of names displayed. The business card will be attached to the message.
  - To insert a calender entry, navigate to Options > Insert object > Calender entry.
  - To change the language, navigate to Options > Writing language.
- Select Continue. The Add recipient view appears. Select the desired recipient or enter number.
- Select Send to send the message. A confirmation message appears as “Message sent”.
- The first SDK sends the message to box_a. The second SDK instance automatically retrieves the message file.
Read the message on the second SDK instance using the simulated phone menus and reply to or forward the message. The second SDK instance automatically sends the message to box_b. The first SDK instance automatically retrieves the message file.
Read the forwarded message on the first SDK instance using the simulated phone menus.

Conceptually, the flow of the message looks like this:

Note: If a message cannot be forwarded because it contains a protected format, such as MIDI, the SDK displays an announcement stating that it cannot send the message.

You can create batch files to set up the exchange of MMS messages. The two batch files would look something like this:

@emulator -Xnew -Xoutbox:c:\box_a -Xinbox:c:\box_b and @emulator -Xnew -Xinbox:c:\box_a -Xoutbox:c:\box_b

You can take advantage of the -Xinbox option, if you set up a deployment directory in an IDE to automatically create MMS messages in the correct directory. Alternatively, you can manually place a message file into the deployment directory.

In either case, the SDK automatically retrieves the MMS message files from that directory, displays the message, and deletes the file.