Type: Binary
Availability: Read or write at any time
The mediaData property contains the data associated with the current medium of the MultiMedia class. The default value is null.
If the mediaName property is set at development time and represents a file, the mediaData binary property holds the contents of that file, and the mediaName property is no longer relevant, as the contents of the file have all been copied to the mediaData property.
Setting the value of the mediaData property to a binary value is equivalent to setting the mediaName property to a file containing that binary data. Any existing mediaData or mediaName property value is discarded. Each available device driver examines the data in turn, until it is recognized as being of a format handled by that driver. It is then loaded ready for playing.
If the data is not recognized or accepted by any device driver, an exception is raised.
If the value of the mediaName property represents a device type (for example, cdaudio) and not a file, this property returns null.
If the value of the mediaName property represents a file, the complete file is read and loaded into the mediaData binary property and then returned to the JADE logic. You should therefore avoid accessing the mediaData property unless necessary, particularly for large files. (For example, if you have a 600M byte audio file, you should use the mediaName property so that the complete file does not have to be loaded into the JADE database but can be accessed from the device.)
JADE handles only binary data that has a length less than the maximum database cache size, so an attempt to store large files in the database may fail. To cover situations where the data is copied by logic, ensure that only files of a size less than half the cache size are stored.