הוספת יכולות לקיצורי הדרך

היכולות ב-shortcuts.xml מאפשרות לכם להצהיר על סוגי הפעולות שהמשתמשים יכולים לבצע כדי להפעיל את האפליקציה ולבצע משימה ספציפית ישירות.

לדוגמה, פעולות באפליקציה של Google Assistant מאפשרות למפתחים להרחיב את התכונות באפליקציה לכוונות מובנות (BIIs), וכך המשתמשים יכולים להפעיל את התכונות האלה ולשלוט בהן באמצעות פקודות קוליות. יכולת מורכבת מהשם של הפעולה ומ-intent שמטרגט את היעד באפליקציה שמספק את כוונת המשתמש.

הגדרת יכולות בקובץ shortcuts.xml

מגדירים את הרכיבים של capability בקובץ המשאב shortcuts.xml בפרויקט לפיתוח אפליקציות ל-Android. כדי להגדיר רכיב capability:

  1. יוצרים משאב shortcuts.xml לפי ההוראות במאמר יצירת קיצורי דרך סטטיים.
  2. צריך לכלול את הפרטים הנדרשים הבאים ביכולת:

    • שם היכולת: הפעולה שבה האפליקציה תתמוך. עיינו במסמכי התיעוד של הרכיבים של התכונה שדורשת הגדרות של יכולות. בפקודות הקוליות של App Actions נעשה שימוש ב-BII‏ Action ID לשמות היכולות. אפשר למצוא את ה-BII בחומר העזר בנושא BII. לדוגמה, ב-BII של GET_THING, הערך של Action ID הוא actions.intent.GET_THING.

    • יעד באפליקציה: היעד באפליקציה שאליו מועברת הפעולה כדי למלא את בקשת המשתמש. מגדירים את יעדי האפליקציה באמצעות רכיבי intent שמוטמעים ב-capability.

    • מיפויי פרמטרים: כל intent עשוי להכיל פרמטרים שיועברו כנתוני extra של ה-Intent. לדוגמה, כל BII של פעולות באפליקציה כולל שדות שמייצגים מידע שמשתמשים מספקים לעיתים קרובות בשאילתות שמפעילות את ה-BII.

בדוגמה הבאה מוצגת הגדרת יכולת ב-shortcuts.xml עבור actions.intent.START_EXERCISE, BII שמאפשר למשתמשים להשתמש בפקודות קוליות עם Assistant כדי להתחיל אימון באפליקציית כושר:

<shortcuts xmlns:android="http://schemas.android.com/apk/res/android">
  <capability android:name="actions.intent.START_EXERCISE">
    <intent
      android:action="android.intent.action.VIEW"
      android:targetPackage="com.example.sampleApp"
      android:targetClass="com.example.sampleApp.ExerciseActivity">
      <parameter
        android:name="exercise.name"
        android:key="exerciseType"/>
    </intent>
  </capability>
</shortcuts>

בדוגמה שלמעלה, המאפיין android:name <capability> מתייחס ל-BII START_EXERCISE. אם משתמש מפעיל את ה-BII הזה על ידי בקשה ל-Assistant, "Ok Google, start a run in ExampleApp", Assistant ממלאת את בקשת המשתמש באמצעות המידע שסופק ברכיב intent המוטמע. השדה intent בדוגמה הזו מגדיר את הפרטים הבאים:

  • השדה android:targetPackage מגדיר את חבילת האפליקציה של היעד לכוונה הזו.
  • השדה android:targetClass מציין את פעילות היעד: com.example.sampleApp.ExerciseActivity.
  • ה-intent parameter מצהיר על תמיכה בפרמטר BII‏ exercise.name ועל האופן שבו מעבירים את ערך הפרמטר – שנאסף מהמשתמש – כנתונים נוספים ב-intent.

שיוך של מקשי קיצור ליכולת

אחרי שמגדירים יכולת, אפשר להרחיב את הפונקציונליות שלה על ידי שיוך של קיצורי דרך סטטיים או דינמיים. האופן שבו קיצורי הדרך מקושרים ל-capability תלוי בתכונה שמופעלת ובמילים בפועל שכלולות בבקשה של המשתמש. לדוגמה, כשמשתמש מתחיל ריצה באפליקציית מעקב הכושר שלכם על ידי בקשה ל-Assistant, "Ok Google, start a run in ExampleApp". Assistant יכולה להשתמש במקש קיצור כדי להפעיל מופע של capability שמגדיר ישות תרגיל תקינה של 'run' לפרמטר exercise.name.

מידע נוסף על שיוך קיצורי דרך לפעולות באפליקציה זמין במאמר סקירה כללית של פעולות באפליקציה.