इस पेज का अनुवाद Cloud Translation API से किया गया है.

इन-ऐप्लिकेशन प्रोमो SDK टूल का इस्तेमाल करके, शॉर्टकट सुझाएं

अपने ऐप्लिकेशन की सुविधाओं का प्रमोशन करने और उसे आसानी से इस्तेमाल करने के लिए, अपने उपयोगकर्ताओं को Assistant के शॉर्टकट का सुझाव दिया जा सकता है. Assistant शॉर्टकट ऐसे छोटे वाक्यांश होते हैं कोई उपयोगकर्ता आपके ऐप्लिकेशन में फ़ंक्शन ट्रिगर करने के लिए बोल सकता है.

Assistant के शॉर्टकट, मैन्युअल तरीक़े से बनाए जा सकते हैं. हालांकि, उपयोगकर्ता इन शॉर्टकट को इन-ऐप्लिकेशन प्रोमो SDK टूल की मदद से, Assistant को सुझाव देने के साथ-साथ उसे लागू किया जा सकता है शॉर्टकट. शॉर्टकट का सुझाव देकर, अपने उपयोगकर्ताओं को साफ़ और आसान तरीके से बिना ज़्यादा मेहनत के आपके ऐप्लिकेशन में अपनी पसंदीदा गतिविधियों पर वापस जा सकता है शॉर्टकट सेट अप करना.

उदाहरण के लिए, अगर कोई उपयोगकर्ता "हैवी मेटल वर्कआउट" खोजता है आपके संगीत में तो आप सीधे उन खोज नतीजों के लिए Assistant के शॉर्टकट का सुझाव दे सकते हैं आने वाले समय में. शॉर्टकट का सुझाव देने पर, आपके ऐप्लिकेशन में एक प्रॉम्प्ट दिखता है. इसमें, शॉर्टकट के लिए सुझाया गया वाक्यांश दिखता है. साथ ही, उपयोगकर्ता से पूछा जाता है कि क्या शॉर्टकट बनाया जा सकता है.

इस उदाहरण में, आपने इस वाक्य का सुझाव दिया है, "मेरी हैवी मेटल शुरू करो" वाली कसरत है." उपयोगकर्ता सुझाव स्वीकार कर लेता है और फिर "Ok Google, हेवी मेटल वर्कआउट शुरू करो" कहकर शॉर्टकट लॉन्च कर सकता है.

अपने ऐप्लिकेशन की ऑडियंस बढ़ाने के तरीकों के बारे में ज़्यादा जानने के लिए, ऐप्लिकेशन ऐक्शन की मदद से अपने ऐप्लिकेशन को आगे बढ़ाना लेख पढ़ें.

इन-ऐप्लिकेशन प्रोमो SDK टूल से ये तरीके इस्तेमाल किए जा सकते हैं:

lookupShortcut: यह जांच करता है कि आपको जिस शॉर्टकट का सुझाव देना है वह पहले से मौजूद है या नहीं. यह तरीका उन समस्याओं की भी जांच करता है जो शॉर्टकट को रोकती हैं बनाए जाने से रोका जा सकता है. अगर शॉर्टकट नहीं बनाया जा सकता, तो lookupShortcut इसकी वजह बताता है.
createShortcutSuggestionIntent: ऐसा इंटेंट दिखाता है जिसका इस्तेमाल किया जा सकता है उपयोगकर्ता को सुझाया गया शॉर्टकट बनाने का निर्देश दें.
createShortcutSettingsIntent: ऐसा इंटेंट दिखाता है जिसका इस्तेमाल आप जगह बदलने के लिए कर सकते हैं उपयोगकर्ता को आपके ऐप्लिकेशन की Assistant की शॉर्टकट सेटिंग पर जाना होगा.

शर्तें और सीमाएं

इस सेक्शन में, सुझावों का इस्तेमाल करने से जुड़ी ज़रूरी शर्तों के साथ-साथ, आपको मिलने वाली सीमाओं के बारे में बताया गया है.

डेवलपमेंट से जुड़ी ज़रूरी शर्तें

सुझावों का इस्तेमाल करने के लिए, आपके डेवलपमेंट एनवायरमेंट को इन शर्तों को पूरा करना होगा ज़रूरी शर्तें.

अपने Android ऐप्लिकेशन को इन कामों के लिए इस्तेमाल करना ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों का इस्तेमाल करें.
अपने मेनिफ़ेस्ट में <queries> टैग में com.google.android.googlequicksearchbox शामिल करें. उदाहरण के लिए:
```
<manifest ...>
  <queries>
    <package android:name="com.google.android.googlequicksearchb>ox&<quot; /
>  /quer<ies
  ...>
/manifest
```
अपने ऐप्लिकेशन पब्लिश करने के लिए, Android ऐप्लिकेशन बंडल का इस्तेमाल करें.

डिवाइस की ज़रूरी शर्तें

किसी डिवाइस पर सुझावों की जांच करने के लिए, आपके डिवाइस पर ये ऐप्लिकेशन इंस्टॉल होने चाहिए.

Google app का सबसे नया वर्शन
Android 6.0 (एपीआई लेवल 23) या इसके बाद का वर्शन

सीमाएं

सुझाव सिर्फ़ अंग्रेज़ी में दिए जा सकते हैं. उपयोगकर्ताओं को आपके सुझाव देखने के लिए, उन्हें अपने डिवाइस पर Assistant की भाषा अंग्रेज़ी पर सेट करनी होगी.

सुझावों को लागू करना

सुझावों को लागू करने के लिए, आपको अपना build.gradle अपडेट करना होगा फ़ाइल, सुझाव क्लाइंट सेट अप करें, और फिर वे सुझाव परिभाषित करें उपयोगकर्ताओं को देना चाहते हैं.

अपनी build.gradle फ़ाइल में लाइब्रेरी डिपेंडेंसी जोड़ें.
```
dependencies {
  ...
  implementation "com.google.assistant.appactions:suggestions:1.0.0"
}
```
AssistantShortcutSuggestionsClient का कोई इंस्टेंस तय करें.
Kotlin
val shortcutsClient = AssistantShortcutSuggestionsClient.builder() .setContext(CONTEXT: Context) .setVerifyIntents(VERIFY_INTENTS: Boolean) .setCustomExecutor(CUSTOM_EXECUTOR: Object) .build()
Java
AssistantShortcutSuggestionsClient shortcutsClient = AssistantShortcutSuggestionsClient.builder() .setContext(CONTEXT: Context) .setVerifyIntents(VERIFY_INTENTS: Boolean) .setCustomExecutor(CUSTOM_EXECUTOR: Object) .build();
इस उदाहरण में:
- CONTEXT (ज़रूरी है) ऐप्लिकेशन का कॉन्टेक्स्ट है.
- VERIFY_INTENTS (ज़रूरी है) से यह तय होता है कि उपयोगकर्ताओं को शॉर्टकट का सुझाव देते समय, बनाए गए हर इंटेंट की पुष्टि की जाए या नहीं. जब true, इंटेंट AssistantShortcutSuggestionsClient ने जो बनाए हैं उनकी पुष्टि हो गई है. अगर आपने कोई इंटेंट अमान्य है, तो एक अपवाद मिला.
- CUSTOM_EXECUTOR (ज़रूरी नहीं) एक कस्टम एक्ज़ीक्यूटर है, जिसका इस्तेमाल एक साथ काम न करने वाले टास्क चलाने के लिए किया जाता है. अगर यह पैरामीटर उपलब्ध नहीं कराया गया है, तो SDK टूल टास्क के लिए एक थ्रेड वाला एक्ज़ीक्यूटर.

lookupShortcut तरीके का इस्तेमाल करके पता लगाएं कि आपको जिस शॉर्टकट का सुझाव देना है वह मान्य है या नहीं. इसके अलावा, यह भी पता लगाया जा सकता है कि शॉर्टकट पहले से मौजूद है या नहीं.

ऐप्लिकेशन शॉर्टकट इंटेंट बनाएं. शॉर्टकट इंटेंट से उस शॉर्टकट के बारे में पता चलता है जिसे आपको किसी उपयोगकर्ता को सुझाना है. यह उदाहरण कोई व्यायाम शुरू करने के लिए एक शॉर्टकट के लिए एक इंटेंट बनाता है.

Kotlin

val exercise = mapOf(
    "@type" to "Exercise",
    "@context" to "http://schema.googleapis.com",
    "name" to "Running",
)

val appShortcutIntent = AppShortcutIntent.builder()
    .setIntentName("actions.intent.START_EXERCISE")
    .setPackageName("my.app.package")
    .setIntentParamName("exercise")
    .setIntentParamValue(exercise)
    .build()

Java

  Map<String, Object> exercise = new HashMap<>();
  exercise.put("@type", "Exercise");
  menuItem.put("@context", "http://schema.googleapis.com");
  menuItem.put("name", "Running");

  AppShortcutIntent appShortcutIntent =
      AppShortcutIntent.builder()
          .setIntentName("actions.intent.START_EXERCISE")
          .setPackageName("my.app.package")
          .setIntentParamName("exercise")
          .setIntentParamValue(exercise)
          .build();

शॉर्टकट इंटेंट को lookupShortcut तरीके में पास करें.

Kotlin

val result = shortcutsClient.lookupShortcut(appShortcutIntent).await()
if (!result.isShortcutPresent) {
    // App can suggest creating a shortcut
} else {
    // App can remind the user that they have a shortcut for this app action
}

Java

shortcutsClient.lookupShortcut(appShortcutIntent)
  .addOnSuccessListener(shortcutLookupResult -> {
    if (!shortcutLookupResult.isShortcutPresent()) {
      // App can suggest creating a shortcut
    } else {
      // App can remind the user that they have a shortcut for this app action
    }
  })
  .addOnFailureListener(e -> Log.e(TAG, "Shortcut lookup failed", e));

शॉर्टकट इंटेंट का इस्तेमाल करके सुझाव बनाएं. सुझाव बनाने के लिए, इन दो तरीकों का इस्तेमाल किया जा सकता है:

createShortcutSuggestionIntent: यह एक Android इंटेंट दिखाता है. इसका इस्तेमाल, ऐप्लिकेशन के संदर्भ में शॉर्टकट के सुझाव वाली गतिविधि शुरू करने के लिए किया जाता है.

Kotlin

val exerciseShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand(PHRASE: String)
    .build()

val intent = shortcutsClient.createShortcutSuggestionIntent(exerciseShortcut).await()
application.startActivity(intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))

Java

  AppShortcutSuggestion exerciseShortcut =
      AppShortcutSuggestion.builder()
          .setAppShortcutIntent(appShortcutIntent)
          .setCommand(PHRASE: String)
          .build();

  shortcutsClient.createShortcutSuggestionIntent(exerciseShortcut)
      .addOnSuccessListener(intent ->
          getApplication().startActivity(
              intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK));
      )
      .addOnFailureListener(e ->
          Log.e(TAG, "Failed to get shortcut suggestion intent", e);
      );

इस उदाहरण में, PHRASE वह वाक्यांश है जिसे आपको उपयोगकर्ता को शॉर्टकट के तौर पर सुझाना है. उदाहरण के लिए, अगर आपको उपयोगकर्ता को शॉर्टकट के तौर पर "Ok Google, रन शुरू करो" बोलने के लिए कहना है, तो PHRASE को "start a run" से बदलें.

Kotlin

val exerciseShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand("start a run")
    .build()

Java

AppShortcutSuggestion exerciseShortcut =
    AppShortcutSuggestion.builder()
        .setAppShortcutIntent(appShortcutIntent)
        .setCommand("start a run")
        .build();

createShortcutSettingsIntent: यह एक Android इंटेंट दिखाता है, जो उपयोगकर्ता को Assistant ऐप्लिकेशन में शॉर्टकट सेटिंग इंटरफ़ेस पर ले जाता है.

Kotlin

val intent = shortcutsClient.createShortcutSettingsIntent().await()
application.startActivity(intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK))

Java

  shortcutsClient.createShortcutSettingsIntent()
    .addOnSuccessListener(intent ->
        getApplication().startActivity(
            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK));
    )
    .addOnFailureListener(e ->
        Log.e(TAG, "Failed to get shortcut settings intent", e);
    );

startActivity पर कॉल करें पिछले चरण के दौरान लौटाए गए Android इंटेंट का इस्तेमाल करके.

ध्यान दें: आपने जिस शॉर्टकट का सुझाव दिया है अगर वह किसी मौजूदा शॉर्टकट से मेल नहीं खाता है, तो उपयोगकर्ता आपके ऐप्लिकेशन के हिसाब से बना रहता है और उसे नया सेट करने के लिए कहा जाता है शॉर्टकट के लिए उच्चारण.

समस्या हल करने के सुझाव

इस सेक्शन में, शॉर्टकट के सुझाव देते समय आने वाली समस्याओं और अपवादों के बारे में बताया गया है.

"GoogleInstallationHelpअपवाद: सेवा से बाइंड नहीं किया जा सकता"

इस वजह से पैकेज दिखाने के लिए फ़िल्टर करना, "GoogleInstallationUnsupportedException: सेवा से बाइंड नहीं किया जा सका" इस दिन हो सकता है Android 11 और उसके बाद के वर्शन. पक्का करें कि com.google.android.googlequicksearchbox आपके मेनिफ़ेस्ट के <queries> टैग में शामिल है:

<manifest ...>
  <queries>
    <package android:name="com.google.android.googlequicksearchb>ox&<quot; /
>  /quer<ies
  ...>
/manifest

"APK हस्ताक्षर की पुष्टि नहीं की जा सकी"

अगर आपने अपने प्रोडक्शन ऐप्लिकेशन को ऐप्लिकेशन बंडल के तौर पर सबमिट नहीं किया है, तो आपको यह गड़बड़ी दिख सकती है:

Failed to verify the APK signature. If this is a development build, please
make sure to update the preview of your app in App Actions Test Tool.

देख लें कि अपने ऐप्लिकेशन को Android ऐप्लिकेशन बंडल के तौर पर सबमिट करें.

"उपयोगकर्ता शॉर्टकट नहीं मिल सके"

"उपयोगकर्ता शॉर्टकट पाने में असफल" गड़बड़ी का मैसेज दिख सकता है, अगर आपने हाल ही में ने डिवाइस से कोई खाता जोड़ा है और नए खाते का शॉर्टकट डेटा कैश मेमोरी में सेव किया गया है.

डिवाइस पर शॉर्टकट का डेटा सिंक करने के लिए, Assistant का शॉर्टकट जोड़ें या मिटाएँ Assistant ऐप्लिकेशन के इंटरफ़ेस का इस्तेमाल करके.

शॉर्टकट बनाने की गतिविधि, कोई कॉन्टेंट दिखाए बिना तुरंत बंद हो जाती है

शॉर्टकट बनाने की गतिविधि को बिना कोई कॉन्टेंट दिखाए बंद किया जा सकता है. ऐसा करने पर, न तो ऐप्लिकेशन की खास सुविधाओं के लिए कार्रवाइयों की जांच करने वाले टूल का इस्तेमाल करके, झलक न बनाएं. इसके अलावा, समय-सीमा खत्म. झलक को अपडेट करके फिर से कोशिश करें.