इस पेज का अनुवाद 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 menuItem = mapOf(
    "@type" to "MenuItem",
    "@context" to "http://schema.googleapis.com",
    "name" to "Fresh Lemon Honey Jasmine Green Tea",
)

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

Java

  Map<String, Object> menuItem = new HashMap<>();
  menuItem.put("@type", "MenuItem");
  menuItem.put("@context", "http://schema.googleapis.com");
  menuItem.put("name", "Fresh Lemon Honey Jasmine Green Tea");

  AppShortcutIntent appShortcutIntent =
      AppShortcutIntent.builder()
          .setIntentName("actions.intent.ORDER_MENU_ITEM")
          .setPackageName("my.app.package")
          .setIntentParamName("menuItem")
          .setIntentParamValue(menuItem)
          .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 orderShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand(PHRASE: String)
    .build()

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

Java

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

  shortcutsClient.createShortcutSuggestionIntent(orderShortcut)
      .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, मेरी बबल टी ऑर्डर करो" कहने के लिए, "order my bubble tea" के साथ PHRASE.

Kotlin

val orderShortcut = AppShortcutSuggestion.builder()
    .setAppShortcutIntent(appShortcutIntent)
    .setCommand("order my bubble tea")
    .build()

Java

AppShortcutSuggestion orderShortcut =
    AppShortcutSuggestion.builder()
        .setAppShortcutIntent(appShortcutIntent)
        .setCommand("order my bubble tea")
        .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 ऐप्लिकेशन के इंटरफ़ेस का इस्तेमाल करके.

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

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