[android] added ability set usage type

Author: RSATom

src/android/AudioHandler.java

@@ -164,7 +164,14 @@ else if (action.equals("getDurationAudio")) {
         else if (action.equals("create")) {
             String id = args.getString(0);
             String src = FileHelper.stripFileProtocol(args.getString(1));
-            getOrCreatePlayer(id, src);
+            AudioPlayer player = getOrCreatePlayer(id, src);
+
+            JSONObject jsonOptions = args.optJSONObject(2);
+            if(jsonOptions != null) {
+                Options options = new Options();
+                options.usage = jsonOptions.optInt("usage", options.usage);
+                player.setOptions(options);
+            }
         }
         else if (action.equals("release")) {
             boolean b = this.release(args.getString(0));

src/android/AudioPlayer.java

@@ -18,6 +18,7 @@ Licensed to the Apache Software Foundation (ASF) under one
 */
 package org.apache.cordova.media;
 
+import android.media.AudioAttributes;
 import android.media.AudioManager;
 import android.media.MediaPlayer;
 import android.media.MediaPlayer.OnCompletionListener;
@@ -39,6 +40,10 @@ Licensed to the Apache Software Foundation (ASF) under one
 import java.io.IOException;
 import java.util.LinkedList;
 
+final class Options {
+    Integer usage = AudioAttributes.USAGE_UNKNOWN;
+}
+
 /**
  * This class implements the audio playback and recording capabilities used by Cordova.
  * It is called by the AudioHandler Cordova class.
@@ -77,6 +82,8 @@ public enum STATE { MEDIA_NONE,
 //    private static int MEDIA_ERR_DECODE         = 3;
 //    private static int MEDIA_ERR_NONE_SUPPORTED = 4;
 
+    private Options options = new Options();
+
     private AudioHandler handler;           // The AudioHandler object
     private String id;                      // The id of this player (used to identify Media object in JavaScript)
     private MODE mode = MODE.NONE;          // Playback or Recording mode
@@ -106,6 +113,10 @@ public AudioPlayer(AudioHandler handler, String id, String file) {
         this.tempFiles = new LinkedList<String>();
     }
 
+    public void  setOptions(Options options) {
+        this.options = options;
+    }
+
     private String generateTempFile() {
       String tempFileName = null;
       if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
@@ -609,6 +620,12 @@ private boolean readyPlayer(String file) {
                 case MEDIA_NONE:
                     if (this.player == null) {
                         this.player = new MediaPlayer();
+                        if(this.options.usage != AudioAttributes.USAGE_UNKNOWN) {
+                            this.player.setAudioAttributes(
+                                new AudioAttributes.Builder()
+                                    .setUsage(options.usage)
+                                    .build());
+                        }
                         this.player.setOnErrorListener(this);
                     }
                     try {
@@ -632,6 +649,12 @@ private boolean readyPlayer(String file) {
                         //maybe it was recording?
                         if (player == null) {
                             this.player = new MediaPlayer();
+                            if(this.options.usage != AudioAttributes.USAGE_UNKNOWN) {
+                                this.player.setAudioAttributes(
+                                    new AudioAttributes.Builder()
+                                        .setUsage(options.usage)
+                                        .build());
+                            }
                             this.player.setOnErrorListener(this);
                             this.prepareOnly = false;
 

www/Media.js

@@ -38,18 +38,21 @@ var mediaObjects = {};
  *                                  errorCallback(int errorCode) - OPTIONAL
  * @param statusCallback        The callback to be called when media status has changed.
  *                                  statusCallback(int statusCode) - OPTIONAL
+ * @param options               The options object.
+ *                                  [android] { usage } - OPTIONAL
  */
-var Media = function (src, successCallback, errorCallback, statusCallback) {
-    argscheck.checkArgs('sFFF', 'Media', arguments);
+var Media = function (src, successCallback, errorCallback, statusCallback, options) {
+    argscheck.checkArgs('sFFFO', 'Media', arguments);
     this.id = utils.createUUID();
     mediaObjects[this.id] = this;
     this.src = src;
     this.successCallback = successCallback;
     this.errorCallback = errorCallback;
     this.statusCallback = statusCallback;
+    this.options = options;
     this._duration = -1;
     this._position = -1;
-    exec(null, this.errorCallback, 'Media', 'create', [this.id, this.src]);
+    exec(null, this.errorCallback, 'Media', 'create', [this.id, this.src, this.options]);
 };
 
 // Media messages