इस पेज का अनुवाद 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.googlequicksearchbox" />
  </queries>
  ...
</manifest>
```
अपने ऐप्लिकेशन पब्लिश करने के लिए, Android ऐप्लिकेशन बंडल का इस्तेमाल करें.

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

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

इसका सबसे नया वर्शन Google ऐप्लिकेशन
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 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, दौड़ना शुरू करो" कहने के लिए, "start a run" के साथ PHRASE.

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.googlequicksearchbox" />
  </queries>
  ...
</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 ऐप्लिकेशन के इंटरफ़ेस का इस्तेमाल करके.

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

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