כוונות מובנות לפעולות באפליקציה

אובייקטים מסוג Intent מובנים (BII) מאפשרים לאפליקציה לבטא את היכולות שלה למילוי הזמנות. ל-Google. על ידי הצהרה על יכולות בקובץ shortcuts.xml ו למפות פרמטרים של Intent למילוי הזמנות, אפשר לאפשר ש-Google Assistant תפעיל את האפליקציה במסך ספציפי בתגובה כדי שהמשתמש יוכל להשלים משימה.

הכוונות המובנות מקובצות לפי קטגוריות של אפליקציות. כל קטגוריה שמייצג קבוצה של משימות נפוצות שמשתמשים רוצים לבצע לעיתים קרובות באפליקציות. הרשימה המלאה של מזהי BII זמינים, הפרמטרים שלהם והדוגמאות שאילתות שניתנות לבדיקה נמצאות בחומר העזר המובנה בנושא Intent.

ל-BII רבים יש דרישות פריסה ספציפיות, המלצות. הדרישות וההמלצות האלה יעזרו לכם לספק את האפליקציה את החוויה הטובה ביותר למשתמשים.

איור 1. הפעלת ה-BII של START_EXERCISE באמצעות קול שאילתה ל-Assistant.

איור 2. להפעיל את האפליקציה למסך ספציפי כדי להתחיל את המשימה START_EXERCISE.

איור 3. הצגת ווידג'ט בתגובה לשאילתה.

​

הטמעת BII וטיפול בפרמטרים של כוונות

לגבי 'פעולות באפליקציה', הצהרה על יכולות וטיפול בפרמטרים של BII בקובץ קיצורי דרך.xml. להטמיע BII ולטפל של הפרמטרים האלה, בצעו את השלבים הבאים:

1. צריך להצהיר על capability עם ה-BII שנבחר.
2. מוסיפים רכיבי parameter מקוננים לכל שדה BII שרוצים להוסיף.
   1. אם משתמשים ב-targetClass או ב-targetPackage, צריך למפות אותם ל-Android כוונה extras באמצעות שם לבחירתך.
   2. אם משתמשים בכתובת URL של קישור עומק, צריך להשתמש בפרמטרים בעלי השם בשאילתה מחרוזת של תבנית כתובת ה-URL.

כדי לטפל בפרמטר BII, צריך למפות את הפרמטר BII תואם לפרמטר התואם של Intent מפורש ב-Android ב-capability. לאחר מכן תוכלו להשתמש בערך שלו באפליקציה. האפליקציה לא נדרשת לטיפול פרמטרים של BII. עם זאת, יש לנסות לטפל בשדות נתונים שסומנו כ'מומלצים' בחומר העזר המובנה של Intent.

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

לדוגמה, actions.intent.START_EXERCISE ב-Intent מומלץ שהאפליקציה שלכם תטפל בפרמטר BII exercise.name, אבל יכול להטמיע את ה-BII באפליקציה ללא פרמטרים. כדאי לעשות זאת אם רוצים לטפל בשאילתות של משתמשים ללא שם של תרגיל, כמו "Ask Example App כדי להתחיל במעקב אחר התרגיל".

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

<?xml version="1.0" encoding="utf-8"?>
<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:targetClass="com.example.myapplication.Activity1"
            android:targetPackage="com.example.myapplication">
            <parameter
                android:name="exercise.name"
                android:key="exerciseType"
                android:required="true"
                />
        </intent>
        <intent
            android:action="android.intent.action.VIEW"
            android:targetClass="com.example.myapplication.Activity2">
        </intent>
    </capability>
</shortcuts>

Google Assistant עושה כמיטב יכולתה כדי לספק את המידע הרלוונטי ביותר המשתמש כשהוא מחזיר ערכי פרמטרים לאפליקציה. לדוגמה, שאילתות משתמש להזמנת פיצה מהאפליקציה לנייד של Example Restaurant לנייד, לא תמיד כוללים המיקום. כדי לשפר את השירות למשתמשים, Assistant עשויה לציין את קו הרוחב וקו האורך של המסעדת Example Restaurant הקרובה ביותר לאפליקציה הזו.

כדרישה נוספת, אינך רוצה שהאפליקציה שלך תבצע באופן ישיר פעולה שמשנה את מצב המשתמש בעולם האמיתי (לדוגמה, העברה כסף, ביצוע הזמנה או שליחת הודעה) בלי לאשר קודם את פעולה עם המשתמש.

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

הבהרה

ארגומנטים שהועברו לאפליקציה שלך דרך <url-parameter> או תוספות ל-Intent לא עשויים שלא לקבל הוא המזהה הייחודי של הפריט שרוצים להציג למשתמש. במקרה הזה, להשתמש בערך הארגומנט כארגומנט חיפוש ולהעביר את המשתמש לחיפוש בדף האפליקציה. הם יכולים לבחור בעצמיים מסוימים ולבחור את הפריט המתאים.

לדוגמה, אם השאילתה של משתמש היא "Order from Example Restaurant (הזמנה ממסעדה לדוגמה) עבור BII ORDER_MENU_ITEM, ניתן להציג למשתמש רשימה של מסעדות שהשמות שלהן תואמים למונח "Example Restaurant".

תמיכה בשפה ובלוקאל

הלוקאלים שנתמכים לצורכי פיתוח ובדיקה בכל BII של פעולה באפליקציה מפורטים בחומר העזר המובנה של Intent. לחלק ממזהי ה-BII יש תמיכה בלוקאל לבדיקת מפתחים ולטריגרים של משתמשים מ-Assistant.