Media API - Revision history

Destinal at 23:26, 5 March 2010

2010-03-05T23:26:06Z

Bsiegel at 18:45, 5 March 2010

2010-03-05T18:45:06Z

Bsiegel at 16:54, 2 March 2010

2010-03-02T16:54:25Z

Bsiegel at 16:48, 2 March 2010

2010-03-02T16:48:32Z

Bsiegel at 16:24, 2 March 2010

2010-03-02T16:24:54Z

Bsiegel at 16:18, 2 March 2010

2010-03-02T16:18:20Z

Bsiegel at 16:18, 2 March 2010

2010-03-02T16:18:00Z

Bsiegel: Initial commit

2010-03-02T15:51:48Z

Initial commit

New page

Here is where you may find research on undocumented Media API calls. The hope is to enable earphone playback, microphone recording, and perhaps even raw video access.

== Playback through earpiece ==
This code will cause further audio playback to be directed to the earpiece:
<source lang="javascript">
var request = new Mojo.Service.Request('palm://com.palm.audio/media', {
method: 'enableScenario',
parameters: { "scenario":"media_front_speaker" },
onSuccess: function() {
var request2 = new Mojo.Service.Request('palm://com.palm.audio/media', {
method: 'setCurrentScenario',
parameters: { "scenario":"media_front_speaker" },
onSuccess: this.playSomeSoundThroughTheEarpiece(),
onFailure: this.doSomethingIfTheMojoCallFails()
});
}.bind(this),
onFailure: this.doSomethingIfTheMojoCallFails()
});
</source>

This code will revert audio playback back to the speaker:
<source lang="javascript">
var request = new Mojo.Service.Request('palm://com.palm.audio/media', {
method: 'disableScenario',
parameters: { "scenario":"media_front_speaker" },
onSuccess: this.playSomeSoundThroughTheBackSpeaker(),
onFailure: this.doSomethingIfTheMojoCallFails()
});
</source>

If you enable the earpiece at some point during your app's run, you MUST remember to reset the playback to use the speaker before your app exits. Always put things back the way you found them!

@@ Line 1: / Line 1: @@
 Here is where you may find research on undocumented Media API calls. The hope is to enable earpiece playback, microphone recording, and perhaps even raw video access.
-Your application must use the "com.palm" namespace to access these APIs. That is, your app's ID must start with "com.palm" if you want to be able to call these services. Sadly this would exclude your app from Palm's App Catalog, though it should be fine for inclusion in Preware.
+Your application must use the "com.palm" namespace to access these APIs. That is, your app's ID must start with "com.palm" if you want to be able to call these services. Sadly, this would exclude your app from Palm's App Catalog, though it should be fine for inclusion in Preware.
 == Playback through earpiece ==

@@ Line 1: / Line 1: @@
 Here is where you may find research on undocumented Media API calls. The hope is to enable earpiece playback, microphone recording, and perhaps even raw video access.
 == Playback through earpiece ==
@@ Line 74: / Line 76: @@
 == Audio recording ==
-There is a test service that the interactive tests use to perform certain actions including recording audio. It is just a wrapper for calling other linux utilities. I would not be surprised if your app's ID must start with "com.palm" to call this service. This is obviously not ideal, since somewhere things like the phone app must be able to access the microphone directly, but it's a start...
+There is a test service that the interactive tests use to perform certain actions including recording audio. It is just a wrapper for calling other linux utilities. This is obviously not ideal, since somewhere things like the phone app must be able to access the microphone directly, but it's a start...

@@ Line 2: / Line 2: @@
 == Playback through earpiece ==
-Earpiece playback is achieved by specifying a new audio playback scenario to the media service.
+Earpiece playback is achieved by specifying a new audio playback scenario to the audio service. There seem to be three main "modes" for audio playback (media, phone, and voice_dialing). These examples control the media mode (which is what application developers will be using) but can be adapted to change other modes too.
@@ Line 38: / Line 38: @@
 The list of available scenarios can be found by calling the 'listScenarios' method:
 <source lang="javascript">
-request = new Mojo.Service.Request("palm://com.palm.audio/phone/listScenarios", {
+request = new Mojo.Service.Request("palm://com.palm.audio/media/listScenarios", {
      parameters: { "enabled": true },
      onSuccess: this.printScenarios(scenarios),
@@ Line 46: / Line 46: @@
-The current list of scenarios seems to be:
+The current list of scenarios for all modes seems to be:
 <pre>
 media_front_speaker
@@ Line 54: / Line 54: @@
 media_a2dp
 media_wireless
 phone_front_speaker
 phone_back_speaker
@@ Line 62: / Line 63: @@
 phone_tty_hco
 phone_tty_vco
 voice_dialing_front_speaker
 voice_dialing_headset

@@ Line 2: / Line 2: @@
 == Playback through earpiece ==
-Earpiece playback is achieved by specifying a new audio playback scenario to the media service. It is unknown at this time what other values for "scenario" exist...
+Earpiece playback is achieved by specifying a new audio playback scenario to the media service.
@@ Line 33: / Line 33: @@
 </source>
 == Audio recording ==

← Older revision		Revision as of 16:18, 2 March 2010
Line 1:		Line 1:
−	Here is where you may find research on undocumented Media API calls. The hope is to enable ~~earphone~~ playback, microphone recording, and perhaps even raw video access.	+	Here is where you may find research on undocumented Media API calls. The hope is to enable earpiece playback, microphone recording, and perhaps even raw video access.

	== Playback through earpiece ==		== Playback through earpiece ==

@@ Line 12: / Line 12: @@
              parameters: { "scenario":"media_front_speaker" },
              onSuccess: this.playSomeSoundThroughTheEarpiece(),
-             onFailure: this.doSomethingIfTheMojoCallFails()
+             onFailure: this.logFailure()
          });
      }.bind(this),
-     onFailure: this.doSomethingIfTheMojoCallFails()
+     onFailure: this.logFailure()
 });
 </source>
@@ Line 25: / Line 25: @@
      method: 'disableScenario',
      parameters: { "scenario":"media_front_speaker" },
-     onSuccess: this.playSomeSoundThroughTheBackSpeaker(),
+     onSuccess: this.logSuccess(),
-     onFailure: this.doSomethingIfTheMojoCallFails()
+     onFailure: this.logFailure()
 });
 </source>
@@ Line 32: / Line 32: @@
 If you enable the earpiece at some point during your app's run, you MUST remember to reset the playback to use the speaker before your app exits. Always put things back the way you found them!