CSPro ⇄ JSON Conversions: Audio Object

A CSPro Audio object is represented as a JSON object with "metadata" and "content" properties. Based on JSON serialization options—defined as an application property or dynamically—the value of the logic object or dictionary item can be serialized either as a data URL or as a localhost URL.

When using Audio.getJson on an Audio specified as a dictionary item, additional properties, "item" and "occurrences", give information about the dictionary item's properties as well as details about the item's occurrences.

For example, serializing an Audio dictionary item, NAME_PRONOUNCATION, to JSON using the default way of representing the binary data as a localhost URL, may look like:

NAME_PRONOUNCATION.getJson()

NAME_PRONOUNCATION.getValueJson()

{
"name": "NAME_PRONOUNCATION",
"type": "Audio",
"item": {
"name": "NAME_PRONOUNCATION",
"labels": [
{
"text": "Respondent Name Pronouncation"
}
],
"contentType": "Audio",
"start": 4,
"length": 1
},
"occurrences": {
"record": 1,
"item": 1
},
"value": {
"metadata": {
"filename": "85-43-44-hans-stueben.m4a",
"mime": "audio/mp4"
},
"content": {
"url": "http://localhost:61549/vf/1/85-43-44-hans-stueben.m4a"
}
}
}

{
"metadata": {
"filename": "85-43-44-hans-stueben.m4a",
"mime": "audio/mp4"
},
"content": {
"url": "http://localhost:61549/vf/1/85-43-44-hans-stueben.m4a"
}
}

To modify an Audio's value from JSON using Audio.setValueFromJson, CSPro can parse binary data as a data URL or can read a file from the disk. An exception occurs if the value is not defined properly or if the data is not valid audio that CSPro can process. For more information, see details on how to specify binary data for JSON deserialization.