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

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

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

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

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

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

2. עליכם לכלול את המידע הנדרש הבא ביכולת שלכם:

   • שם יכולת: הפעולה שבה האפליקציה תתמוך. פרטים נוספים תיעוד הרכיבים של התכונה שדורשת יכולת הגדרות. פקודות להפעלה קולית של פעולות באפליקציה משתמשות ב-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.

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