From 2fe6fd055874ff70a9faeaa27716173b12e671fb Mon Sep 17 00:00:00 2001
From: Mike LeBeau <mlebeau@android.com>
Date: Wed, 8 Sep 2010 19:10:17 -0400
Subject: Add MediaStore.ACTION_MEDIA_PLAY_FROM_SEARCH intent for open-ended
 search and play of music. This is used, for instance, by Google's new "listen
 to" Voice Action.

Change-Id: Ibbc81701cc2412ffd57402d34f22d9764e9df7c2
---
 api/current.xml                            | 11 +++++++++++
 core/java/android/provider/MediaStore.java | 16 ++++++++++++++++
 2 files changed, 27 insertions(+)

diff --git a/api/current.xml b/api/current.xml
index 1abf681a21c8..a495d047eb0e 100644
--- a/api/current.xml
+++ b/api/current.xml
@@ -140773,6 +140773,17 @@
  visibility="public"
 >
 </field>
+<field name="INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH"
+ type="java.lang.String"
+ transient="false"
+ volatile="false"
+ value="&quot;android.media.action.MEDIA_PLAY_FROM_SEARCH&quot;"
+ static="true"
+ final="true"
+ deprecated="not deprecated"
+ visibility="public"
+>
+</field>
 <field name="INTENT_ACTION_MEDIA_SEARCH"
  type="java.lang.String"
  transient="false"
diff --git a/core/java/android/provider/MediaStore.java b/core/java/android/provider/MediaStore.java
index d20e89dcae1b..075da338cb39 100644
--- a/core/java/android/provider/MediaStore.java
+++ b/core/java/android/provider/MediaStore.java
@@ -74,6 +74,22 @@ public final class MediaStore {
     @SdkConstant(SdkConstantType.ACTIVITY_INTENT_ACTION)
     public static final String INTENT_ACTION_MEDIA_SEARCH = "android.intent.action.MEDIA_SEARCH";
 
+    /**
+     * An intent to perform a search for music media and automatically play content from the
+     * result when possible. This can be fired, for example, by the result of a voice recognition
+     * command to listen to music.
+     * <p>
+     * Contains the {@link android.app.SearchManager#QUERY} extra, which is a string
+     * that can contain any type of unstructured music search, like the name of an artist,
+     * an album, a song, a genre, or any combination of these.
+     * <p>
+     * Because this intent includes an open-ended unstructured search string, it makes the most
+     * sense for apps that can support large-scale search of music, such as services connected
+     * to an online database of music which can be streamed and played on the device.
+     */
+    public static final String INTENT_ACTION_MEDIA_PLAY_FROM_SEARCH =
+            "android.media.action.MEDIA_PLAY_FROM_SEARCH";
+    
     /**
      * The name of the Intent-extra used to define the artist
      */
-- 
cgit v1.2.3-59-g8ed1b