MyVox 1.11 contains three new features for you to use in your applications.  They are:

• Emailing of recordings
• Podcast generation
• Applying review to recordings

Emailing of recordings:  As of 1.1, recordings were either stored by MyVox for later use by your app, or they were passed to your app for local storage.  Now, there is a third possibility:  have a recording emailed directly to an email address.  You can use this as an alternative way to pass recordings back to your application, or as a way to push recordings out to your individual users.  To use this feature, go to My Projects and choose the voice recorder you want to work with, then select the Advanced Options tab.  If you check the "Email Recordings" checkbox, then all recordings will be emailed automatically, as an attachment to the email.  You can specify other content of the email by filling in the other fields here.  What's more, you can have your email subject and/or body refer to attributes of the recording by including one of many special tags MyVox supports:

• <voice_recorder_name> - The Voice Recorder 'name' value
• <voice_recorder_key> - The Voice Recorder 'voice_recorder_key' value
• <recording_list_name> - The Recording List 'name' value
• <recording_list_key> - The Recording List 'recording_list_key' value
• <recording_list_metadata1> - The Recording List 'meta_data_1' value
• <recording_list_metadata2> - The Recording List 'meta_data_2' value
• <recording_list_metadata3> - The Recording List 'meta_data_3' value
• <recording_session_date> - The Recording Session 'last_accessed' value

Once it's time to create a recording, put it in a recording list with the email_address attribute specified.  Any recordings you make in that recording list will go straight to that email address, with the email subject and body you specified when you created the voice recorder.

Try out this simple example app, which will take a recording from you over the phone, then email it to you.

Podcast generation:  Now, whenever you create a recording list, you can make it act like a podcast.  Whenever new recordings are made in that recording list, they will automatically become new, syndicated episodes in the podcast.  To do this, you need to set the "podcast_enabled" attribute on your recording list.  Once this is set, you'll get a "podcast_url" attribute in the response to the GetRecordingList command, which will contain the URL for the podcast.  There are many additional attributes you can use to configure your podcast; please refer to the core MyVox API documentation, and also to the iTunes podcast specification, which MyVox uses as its reference.  All podcasts created through MyVox should be compatible with the iTunes store.

This example app takes a recording from you over the phone, then adds it to a podcast.  You can then subscribe to that podcast, and hear your recording as the latest "episode". As other people's recordings come in, they become new episodes in the podcast.

Applying review to recordings:  Some applications create user-generated content that you don't necessarily want to post publicly before manually reviewing it, to make sure the content is appropriate.  Because this is a common need, we added two new status fields to recordings: "global_review_status" and "local_review_status".  Each starts with a value of "pending", and can be set to "accepted" or "rejected".  If you set the "Global Review Required" checkbox on your voice recorder (see Advanced Options for your voice recorder under My Projects), then the API will be sensitive to the "global_review_status" of each recording, and all recordings must be approved with the new ReviewRecording and SetReviewStatus commands that have been added to the API.  This is good for projects where you want to make sure every recording is reviewed by you before anybody else sees it.  Alternately, you can set a single recording list to require review, using the new "local_review_required" attribute of the recording list.  If you do this, then the local_review_status field will be used, though you will not be prevented from accessing the recordings through the usual commands - it's just a useful bookkeeping feature.

You can see the review capabilities in action in this example application.