תחילת העבודה עם פעולות קוליות במערכת

הפעולות של Google Voice מזהה בקשות רבות של הקלדה והקלדה ויוצרות להן כוונות Android. אפליקציות כמו Play Music ו-Keep יכולות לקבל את כוונת הרכישה ולבצע את הפעולה הרצויה. האפליקציה יכולה להצהיר על תמיכה גם בחלק מהפעולות הבאות:

1. הגדרת מסנן Intent
2. צריך לנהל את הכוונה באפליקציה
3. עדכון סטטוס השלמת האפליקציה

רשימה מפורטת של פעולות המערכת הנתמכות זמינה במאמר מידע על פעולות מערכת.

שלב 1: הגדרת מסנן Intent

כדי לציין שהאפליקציה שלכם תומכת בפעולת מערכת אחת או יותר, עליכם לכלול מסנן Intent לכל פעולה בקובץ המניפסט של האפליקציה.

לדוגמה, אם האפליקציה יכולה להגדיר התראה, הוסיפו את מסנן הכוונות הבא לקובץ המניפסט:

<activity ...>
    <intent-filter>
        <action android:name="android.intent.action.SET_ALARM"/>
        <category android:name="android.intent.category.DEFAULT"/>
    </intent-filter>
</activity>

אם למשתמש יש מספר אפליקציות שיכולות לטפל בכוונת הגדרת התראה, פעולות Google Voice מאפשרות לו לבחור את האפליקציה כדי להשלים את הפעולה:

איור 1: פעולות קוליות מאפשרות למשתמשים לבחור מתוך אפליקציות שתומכות בפעולות מערכת.

שלב 2: טיפול בכוונת האפליקציה

כשהאפליקציה מקבלת את הכוונה, היא צריכה לבצע את הפעולה. בדוגמה הזו צריך להגדיר את ההתראה. דוגמה לקוד:

שלב 3: מעדכנים את הסטטוס של השלמת האפליקציה

ה-App Indexing API מאפשר לשלוח ל-Google פעילויות שהושלמו. לאחר מכן Google יכולה להציג את התוכן שלכם למשתמשים שוב, באמצעות השלמות אוטומטיות של אפליקציית Google.

אחרי שהאפליקציה מבצעת פעולה, צריך לקרוא לשיטה AppIndexApi.end() ולציין את סוג הפעולה המתאים, לדוגמה: Action.TYPE_ADD.

בנוסף, יש להגדיר את סוג הסטטוס המתאים של הפעולה כדי לדווח אם הפעולה הושלמה בהצלחה או לא. אפשר להשתמש בשיטת setActionStatus כדי להגדיר את הסטטוס של פעולה מסוימת.

לפניכם דוגמה מלאה להדגמה של האופן שבו יש לטפל בכוונה הנכנסת ושימוש ב-App Indexing API כדי לדווח שהמשתמש הצליח להגדיר התראה:

public class MainActivity extends Activity {

    private static final Uri ALARM_URI = Uri.parse("android-app://com.myclockapp/set_alarm_page");

    @Override
    public void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        ...

        // Get the intent
        Intent intent = getIntent();
        if (AlarmClock.ACTION_SET_ALARM.equals(intent.getAction())) {
            if (intent.hasExtra(AlarmClock.EXTRA_HOUR)) {
                // Step 2: get the rest of the intent extras and set an alarm
                ...
            }

            // Step 3: report the action through the App Indexing API
            Thing alarm = new Thing.Builder()
                    .setName("Alarm for 4:00 PM")
                    .setDescription("Alarm set for 4:00 PM, with the 'Argon' ringtone"
                                    + " and vibrate turned on.")
                    .setUrl(APP_URI)
                    .build();

            Action setAlarmAction = new Action.Builder(Action.TYPE_ADD)
                    .setObject(alarm)
                    .setActionStatus(Action.STATUS_TYPE_COMPLETED)
                    .build();

            AppIndex.AppIndexApi.end(mClient, setAlarmAction);
        }
    }

    ...

}

הפניה לפעולות מערכת

הפעולות של Google Voice מופעלות כשהמערכת מזהה פעולה כלשהי שמפורטת בטבלאות הבאות.

פעולות בשעון המעורר

פעולה	פקודה לדוגמה
הגדרת שעון מעורר	הגדרת שעון מעורר לשעה 6:00
הגדרת טיימר	הגדרת טיימר ל-5 דקות

פעולות תקשורת

פעולה	פקודה לדוגמה
ביצוע שיחת טלפון	התקשרו למספר 555-5555 Call Starbucks call mom call דואר קולי

פעולות השיחה מופעלות רק במכשירים עם חייגן מובנה (כמו טלפון) ובמכשירים עם אפליקציות שתומכות בחיוג (כמו טאבלט עם אפליקציית VoIP).

פעולות כושר

פעולה	פקודה לדוגמה
התחלה/עצירה של רכיבה על אופניים	להתחיל רכיבה על אופניים
התחלה/הפסקה של ריצה	להתחלת ריצה
התחלה/הפסקה של אימון כושר	התחלת אימון כושר
הצגת הדופק	הצגת הדופק
הצגת ספירת צעדים	הצגת ספירת צעדים

פעולות מקומיות

פעולה	פקודה לדוגמה
הזמנת מונית	הזמנת מונית

הפעולה הזמנת מונית מופעלת רק ב-Android Wear.

פעולות במדיה

פעולה	פקודה לדוגמה
השמעת מוזיקה מהחיפוש	play micelel jackson byie jean play some music הפעלת מוזיקה קלאסית הפעלה מחוץ לקיר הפעלת ורוד ורוד על vnstreamer
צילום תמונה	צילום תמונה
הקלטת סרטון	הקלטת סרטון

פעולות פתוחות

פעולה	פקודה לדוגמה
כתובת URL פתוחה	open twitter.com
פתיחת אפליקציה	open twitter (פועלת כברירת מחדל, ללא כוונה ספציפית).

פעולות לשיפור הפרודוקטיביות

פעולה	פקודה לדוגמה
להוספת הערה	כתיבת הערה לגבי מכולת

פעולות חיפוש

פעולה	פקודה לדוגמה
חיפוש באמצעות אפליקציה ספציפית	חיפוש סרטונים על חתולים ב-YouTube