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

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

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

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

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

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

2. צריך לכלול את הפרטים הנדרשים הבאים ביכולת:

   • שם היכולת: הפעולה שרוצים שהאפליקציה תתמוך בה. פרטים נוספים תיעוד הרכיבים של התכונה שדורשת יכולת הגדרות. בפקודות הקוליות של App Actions נעשה שימוש ב-BII‏ Action ID לשמות היכולות. אפשר למצוא אותם בחומר העזר בנושא 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, אני רוצה להתחיל הרצה ב-ExampleApp, Assistant ממלאת את בקשת המשתמש באמצעות מידע שסופק ברכיב intent המקונן. השדה intent בדוגמה הזו מגדיר את הפרטים הבאים:

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

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

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

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