Google Assistant Library

google.assistant.library पैकेज.

क्लास google.assistant.library.Assistant(क्रेडेंशियल, device_model_id)

Google Assistant लाइब्रेरी के लिए क्लाइंट.

इससे Google Assistant को बुनियादी फ़ंक्शन और लाइफ़साइकल हैंडल करने की सुविधा मिलती है. Assistant को ContextManager के तौर पर इस्तेमाल करना सबसे सही तरीका है:

with Assistant(credentials, device_model_id) as assistant:

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

start() को कॉल करने के बाद, Assistant उन इवेंट को स्ट्रीम करती है जिनमें Assistant फ़िलहाल मौजूद है. उदाहरण के लिए:

ON_CONVERSATION_TURN_STARTED
ON_END_OF_UTTERANCE
ON_RECOGNIZING_SPEECH_FINISHED:
    {'text': 'what time is it'}
ON_RESPONDING_STARTED:
    {'is_error_response': False}
ON_RESPONDING_FINISHED
ON_CONVERSATION_TURN_FINISHED:
    {'with_follow_on_turn': False}

सभी इवेंट और उनके तर्कों की जानकारी के लिए EventType देखें.

shabadawalee

  • हॉटवर्ड: वह वाक्यांश जिसे म्यूट न किए जाने पर Assistant सुनती है:

    "OK Google" OR "Hey Google"

  • सलाह: एक उपयोगकर्ता का अनुरोध और उसके बाद Assistant का जवाब.

  • बातचीत: Assistant से एक या एक से ज़्यादा ऐसे नतीजे चाहिए जो मनचाहे नतीजे में हों:

    "What time is it?" -> "The time is 6:24 PM" OR
"Set a timer" -> "Okay, for how long?" ->
"5 minutes" -> "Sure, 5 minutes, starting now!"
पैरामीटर:
  • क्रेडेंशियल (google.oauth2.क्रेडेंशियल.क्रेडेंशियल) – उपयोगकर्ता के Google OAuth2 क्रेडेंशियल.
  • device_model_id (str) – device_model_id, जिसे Google के साथ आपके प्रोजेक्ट के लिए रजिस्टर किया गया था. यह स्ट्रिंग खाली नहीं होनी चाहिए.
यह:

ValueError – अगर device_model_id को 'कोई नहीं' या 'खाली' के तौर पर छोड़ा गया.
device_id

Assistant से जनरेट किया गया डिवाइस आईडी दिखाता है.

यह मान Google Device Actions जैसी सेवाओं का इस्तेमाल करते समय, सर्वर पर आपके डिवाइस की पहचान करता है. यह प्रॉपर्टी सिर्फ़ तब ही भरी जाती है, जब start() को कॉल किया जाता है.

वापसी:डिवाइस आईडी start() को एक बार कॉल करने पर, खाली स्ट्रिंग बरकरार रहती है.
रिटर्न टाइप:एसटीआर
send_text_query(क्वेरी)

|query| Assistant को इस तरह भेजता है जैसे उपयोगकर्ता ने बोला हो.

यह उसी तरह काम करेगा जैसे कोई उपयोगकर्ता हॉटवर्ड और क्वेरी करता है या फ़ॉलो-ऑन क्वेरी में जवाब बोलता है.

पैरामीटर:query (str) – Assistant को भेजने के लिए टेक्स्ट क्वेरी.
set_mic_mute(is_म्यूट किया गया)

Assistant को हॉटवर्ड सुनने से रोकता है.

Assistant को हॉटवर्ड सुनने से रोकने की अनुमति देता है. इससे Google Home के पीछे मौजूद, निजता बटन से मिलती-जुलती सुविधा मिलती है.

अगर Assistant को अभी चालू नहीं किया गया है, तो यह तरीक़ा नहीं है.

पैरामीटर:is_म्यूट किया गया (bool) – True है, तो Assistant इसे सुन नहीं पाएगी और 'गलत' पर सेट कर देगी.
start()

Assistant शुरू करता है, जिसमें हॉटवर्ड सुनना शामिल है.

start() को कॉल करने के बाद Assistant, 'डिफ़ॉल्ट' ALSA ऑडियो सोर्स से, डेटा को प्रोसेस करना शुरू करेगी और हॉटवर्ड सुनेगी. इससे Assistant से मिलने वाली दूसरी सेवाएं भी शुरू हो जाएँगी, जैसे कि टाइमर/अलार्म. इस तरीके को सिर्फ़ एक बार कॉल किया जा सकता है. कॉल के बाद, Assistant __exit__ को कॉल करने तक चलता रहेगा.

वापसी:ऐसे इवेंट की सूची जिसमें Assistant की स्थिति में हुए बदलावों के बारे में बताया जाता है.
रिटर्न टाइप:google.assistant.event.IterableEventQueue
start_conversation()

Assistant के साथ मैन्युअल तरीके से नई बातचीत शुरू करती है.

उपयोगकर्ता की आवाज़ रिकॉर्ड करना और Google को भेजना, दोनों ही शुरू हो जाते हैं. यह ठीक उसी तरह होता है जिस तरह Assistant Assistant को सुनती है.

अगर Assistant को शुरू नहीं किया गया है या म्यूट किया गया है, तो यह तरीका नहीं है.

stop_conversation()

Assistant के साथ की जा रही किसी भी चल रही बातचीत को बंद कर देती है.

Assistant, उपयोगकर्ता की क्वेरी सुन रही है या जवाब दे रही है. अगर कोई बातचीत चल नहीं रही है, तो इसे कोई विकल्प नहीं माना जा सकता.

क्लास google.assistant.library.event.AlertEvent(event_type, आर्ग्युमेंट, **_)

यह 'चेतावनी' टाइप को पार्स करने के लिए, इवेंट को बढ़ाता है.

क्लास google.assistant.library.event.AlertType

चेतावनी के टाइप.

इसका इस्तेमाल ON_ALERT_STARTED और ON_ALERT_FINISHED इवेंट के साथ किया जाता है.

ALARM = 0ग्राफ़

बिल्कुल सही समय के लिए सेट किया गया इवेंट, जैसे कि ‘सोमवार को सुबह 3 बजे’

TIMER = 1

मिलते-जुलते समय के लिए सेट किया गया इवेंट, जैसे कि ‘अभी से 30 सेकंड’

क्लास google.assistant.library.event.DeviceActionEvent(event_type, आर्ग्युमेंट, **kwargs)

यह विकल्प, 'कार्रवाइयां' प्रॉपर्टी जोड़ने के लिए इवेंट को बढ़ाता है.

actions

मौजूदा डिवाइस पर चलाने के लिए, निर्देशों का जनरेटर.

क्लास google.assistant.library.event.Event(event_type, आर्ग्युमेंट, **_)

Assistant से बनाया गया एक इवेंट.

type

EventType – जनरेट किया गया इवेंट किस तरह का है.

args

dict – इस इवेंट से जुड़ी आर्ग्युमेंट की/वैल्यू पेयर.

स्टैटिक New(event_type, आर्ग्युमेंट, **kwargs)

ज़रूरत पड़ने पर किसी खास इवेंट क्लास का इस्तेमाल करके नया इवेंट बनाएं.

पैरामीटर:
  • event_type (int) – google.assistant.event.EventType में किसी इवेंट से जुड़ा संख्या वाला आईडी.
  • args (dict) – इस इवेंट से जुड़े आर्ग्युमेंट की/वैल्यू पेयर.
  • kwargs (dict) – किसी इवेंट टाइप के लिए इवेंट क्लास की विशेषज्ञता के लिए, खास तौर पर आर्ग्युमेंट की/वैल्यू पेयर.
क्लास google.assistant.library.event.EventType

इवेंट के टाइप.

ON_ALERT_FINISHED = 11

इससे पता चलता है कि alert_type की चेतावनी बज चुकी है.

पैरामीटर:alert_type (AlertType) – चेतावनी का टाइप दिखाने वाले Enum का आईडी, जो अभी-अभी खत्म हुआ है.
ON_ALERT_STARTED = 10

इससे पता चलता है कि चेतावनी सुनाई देने लगी है.

यह सूचना ON_ALERT_FINISHED जब तक उसी alert_type के मिलने तक जारी रहेगी. एक समय पर सिर्फ़ एक चेतावनी चालू होनी चाहिए.

पैरामीटर:alert_type (AlertType) – चेतावनी का मौजूदा टाइप दिखाने वाले Enum का आईडी.
ON_ASSISTANT_ERROR = 12ग्राफ़

इससे पता चलता है कि Assistant की लाइब्रेरी में कोई गड़बड़ी हुई है.

पैरामीटर:is_ वैल्यू वाला एजेंट (bool) – अगर 'सही है' पर सेट किया जाता है, तो Assistant वापस नहीं आ पाएगी और इसे रीस्टार्ट करना होगा.
ON_CONVERSATION_TURN_FINISHED = 9

Assistant ने मौजूदा मोड़ पूरा कर लिया.

इसमें उपयोगकर्ता की क्वेरी को प्रोसेस करना और पूरा जवाब देना शामिल है, अगर कोई हो.

पैरामीटर:with_फ़ॉलो_on_turn (बूल) – अगर सही है, तो Assistant को उपयोगकर्ता से फ़ॉलो अप इंटरैक्शन की उम्मीद है. उपयोगकर्ता को फ़ॉलो-अप सवाल का जवाब देने की अनुमति देने के लिए, माइक्रोफ़ोन फिर से खोला जाएगा.
ON_CONVERSATION_TURN_STARTED = 1

इससे पता चलता है कि नया मोड़ शुरू हो गया है.

Assistant, फ़िलहाल उपयोगकर्ता की क्वेरी का इंतज़ार कर रही है. ऐसा होने पर, Assistant को कॉल करने या start_conversation() को कॉल करने का नतीजा हो सकता है.

ON_CONVERSATION_TURN_TIMEOUT = 2ग्राफ़

Assistant के समझ में न आने वाली क्वेरी के इंतज़ार का समय खत्म हो गया.

ऐसा, हॉटशब्द के किसी गलत ट्रिगर की वजह से हो सकता था या Assistant समझ नहीं पाई थी कि उपयोगकर्ता ने क्या कहा.

ON_DEVICE_ACTION = 14ɶ

इससे पता चलता है कि डिवाइस की कार्रवाई के लिए अनुरोध, डिवाइस पर भेज दिया गया है.

अगर डिवाइस में काम करने वाले किसी खास के लिए कोई डिवाइस व्याकरण ट्रिगर होता है, तो उसे भेज दिया जाता है. इस तरह के इवेंट में एक खास ‘कार्रवाइयां’ प्रॉपर्टी होती है, जो इटरेटर या डिवाइस कार्रवाई से जुड़े निर्देश दिखाती है और उनसे जुड़े पैरामीटर (अगर लागू हो) दिखाती है.

पैरामीटर:dict – डिवाइस कार्रवाई अनुरोध का डिकोड किया गया JSON पेलोड.
ON_END_OF_UTTERANCE = 3ग्राफ़

Assistant ने उपयोगकर्ता की क्वेरी सुनना बंद कर दिया है.

हो सकता है कि Assistant ने उपयोगकर्ता की बात समझ न ली हो, लेकिन ऑडियो डेटा सुनना बंद कर दिया हो.

ON_MEDIA_STATE_ERROR = 20

यह बताता है कि ट्रैक चलाने के दौरान कोई गड़बड़ी हुई.

डिवाइस में पहले से मौजूद मीडिया प्लेयर, अगले ट्रैक पर जाने या ON_MEDIA_STATE_IDLE पर वापस जाने की कोशिश करेगा, ताकि वीडियो चलाने के लिए कुछ बचा न हो.

ON_MEDIA_STATE_IDLE = 16

इससे यह पता चलता है कि खेलने के लिए कुछ भी नहीं है और खेलने के लिए कुछ भी कतार में नहीं है.

इस इवेंट को Google Assistant लाइब्रेरी के बिल्ट-इन मीडिया प्लेयर में, शुरू होने पर समाचार/पॉडकास्ट के लिए ब्रॉडकास्ट किया जाता है. साथ ही, जब कोई उपयोगकर्ता मीडिया को रोकने या स्ट्रीम रोकने का समय खत्म कर देता है, तब भी प्लेयर का इस्तेमाल नहीं किया जाता.

ON_MEDIA_TRACK_LOAD = 17

इससे पता चलता है कि ट्रैक लोड हो रहा है, लेकिन अभी शुरू नहीं हुआ है.

अगर नया मेटाडेटा एसिंक्रोनस तरीके से लोड किया जाता है, तो इसे कई बार भेजा जा सकता है. आम तौर पर, इसके बाद इवेंट ON_MEDIA_TRACK_PLAY होता है

पैरामीटर:
  • मेटाडेटा (शब्द के मुताबिक) –

    लोड किए गए ट्रैक के लिए मेटाडेटा. इस समय सभी फ़ील्ड नहीं भरे जाएंगे – अगर कोई फ़ील्ड अज्ञात है, तो उसे शामिल नहीं किया जाएगा. मेटाडेटा फ़ील्ड में ये शामिल हैं:

    एल्बम(str): उस एल्बम का नाम जिसका ट्रैक है. एल्बम_art(str): एल्बम आर्ट का यूआरएल. कलाकार(str): वह कलाकार जिसने इस ट्रैक को बनाया है. duration_ms(डबल): ट्रैक की लंबाई मिलीसेकंड में. title(str): ट्रैक का शीर्षक.
  • track_type (MediaTrackType) – लोड किए गए ट्रैक का टाइप.
ON_MEDIA_TRACK_PLAY = 18ग्राफ़

इससे पता चलता है कि फ़िलहाल कोई ट्रैक ऑडियो से बाहर चल रहा है.

यह सिर्फ़ तब ट्रिगर होगा, जब हम एक राज्य से दूसरे पर जाएंगे, जैसे कि ON_MEDIA_TRACK_LOAD या ON_MEDIA_TRACK_STOP

पैरामीटर:
  • मेटाडेटा (शब्द के मुताबिक) –

    चल रहे ट्रैक का मेटाडेटा. अगर फ़ील्ड के बारे में जानकारी नहीं है, तो उसे शामिल नहीं किया जाएगा. मेटाडेटा फ़ील्ड में ये शामिल हैं:

    एल्बम(str): उस एल्बम का नाम जिसका ट्रैक है. एल्बम_art(str): एल्बम आर्ट का यूआरएल. कलाकार(str): वह कलाकार जिसने इस ट्रैक को बनाया है. duration_ms(डबल): ट्रैक की लंबाई मिलीसेकंड में. title(str): ट्रैक का शीर्षक.
  • position_ms (डबल) – शुरुआत से ही मिलीसेकंड में प्लेइंग ट्रैक की मौजूदा स्थिति. अगर “metadata.duration_ms” पता नहीं है (0 पर सेट करें) तो यह फ़ील्ड सेट नहीं होगा.
  • track_type (MediaTrackType) – ट्रैक चलाने का टाइप.
ON_MEDIA_TRACK_STOP = 19

इससे पता चलता है कि पहले से चल रहे ट्रैक को रोक दिया गया है.

आम तौर पर, ऐसा तब होता है, जब उपयोगकर्ता उस पर रोक लगाता है. अगर उपयोगकर्ता ट्रैक को दोबारा चालू करता है, तो ट्रैक ON_MEDIA_TRACK_PLAY पर वापस आ सकता है.

पैरामीटर:
  • मेटाडेटा (शब्द के मुताबिक) –

    रोके गए ट्रैक का मेटाडेटा. अगर फ़ील्ड के बारे में जानकारी नहीं है, तो उसे शामिल नहीं किया जाएगा. मेटाडेटा फ़ील्ड में ये शामिल हैं:

    एल्बम(str): उस एल्बम का नाम जिसका ट्रैक है. एल्बम_art(str): एल्बम आर्ट का यूआरएल. कलाकार(str): वह कलाकार जिसने इस ट्रैक को बनाया है. duration_ms(डबल): ट्रैक की लंबाई मिलीसेकंड में. title(str): ट्रैक का शीर्षक.
  • position_ms (डबल) – शुरुआत में रोके गए ट्रैक में मौजूदा सेकंड में मौजूदा स्थिति. अगर “metadata.duration_ms” पता नहीं है (0 पर सेट करें) तो यह फ़ील्ड सेट नहीं होगा.
  • track_type (MediaTrackType) – ट्रैक का टाइप रोका गया.
ON_MUTED_CHANGED = 13

इससे पता चलता है कि फ़िलहाल Assistant सुन रही है या नहीं.

start() हमेशा शुरुआती मान की रिपोर्ट करने के लिए ON_MUTED_CHANGED जनरेट करेगा.

पैरामीटर:is_म्यूट किया गया (bool) – अगर सही है, तो फ़िलहाल Assistant आपके हॉटवर्ड नहीं सुन रही है और उपयोगकर्ता की क्वेरी का जवाब नहीं देगी.
ON_NO_RESPONSE = 8ग्राफ़

Assistant ने अपनी बारी पूरी कर ली, लेकिन उसे कुछ कहना नहीं है.

ON_RECOGNIZING_SPEECH_FINISHED = 5ग्राफ़

Assistant ने बोली पहचानने का आखिरी तरीका तय किया है.

पैरामीटर:text (str) – उपयोगकर्ता की क्वेरी का आखिरी टेक्स्ट.
ON_RENDER_RESPONSE = 15ग्राफ़

इससे पता चलता है कि Assistant के पास, जवाब देने के लिए टेक्स्ट आउटपुट है.

पैरामीटर:
  • type (RenderResponseType) – रेंडर करने के लिए जवाब का टाइप.
  • text (str) – वह स्ट्रिंग जो RenderResponseType.TEXT के लिए रेंडर करनी होती है.
ON_RESPONDING_FINISHED = 7ग्राफ़

Assistant ने आवाज़ से जवाब देना बंद कर दिया है.

ON_RESPONDING_STARTED = 6ग्राफ़

Assistant आवाज़ का जवाब देना शुरू कर रही है.

Assistant जवाब देने के लिए, ON_RESPONDING_FINISHED का इस्तेमाल करेगी.

पैरामीटर:is_error_response (bool) – 'सही' का मतलब है कि स्थानीय गड़बड़ी टीटीएस चलाई जा रही है, नहीं तो सर्वर जवाब देता है.
ON_START_FINISHED = 0ग्राफ़

Assistant की लाइब्रेरी बंद हो गई है.

क्लास google.assistant.library.event.IterableEventQueue(timeout=3600)

सूची में __iter__ इंटरफ़ेस जोड़ने के लिए, सूची को बड़ा करें.

offer(इवेंट)

सूची में शामिल करने के लिए, कोई इवेंट ऑफ़र करें.

इवेंट की सूची में अभी और लोग शामिल होने पर, इवेंट लॉग कर दिया जाएगा. हालांकि, उसे जोड़ा नहीं जाएगा.

पैरामीटर:इवेंट (इवेंट) – वह इवेंट जिसे सूची में जोड़ने की कोशिश करनी है.
क्लास google.assistant.library.event.MediaStateChangeEvent(event_type, आर्ग्युमेंट, **_)

'स्टेटस' को पार्स करने के लिए इवेंट को बढ़ाता है.

क्लास google.assistant.library.event.MediaTrackType

ON_MEDIA_UPDATE_X इवेंट के लिए ट्रैक के प्रकार.

ON_MEDIA_TRACK_LOAD, ON_MEDIA_TRACK_PLAY, और ON_MEDIA_TRACK_STOP को इस्तेमाल किया गया है

CONTENT = 2ग्राफ़

किसी आइटम का असल कॉन्टेंट (खबरें/पॉडकास्ट).

TTS = 1

किसी आइटम से जुड़े टीटीएस की जानकारी या अचानक दिखने वाले ट्रैक.

क्लास google.assistant.library.event.RenderResponseEvent(event_type, आर्ग्युमेंट, **_)

यह ‘इवेंट के टाइप’ में मौजूद पार्सिंग को जोड़ने के लिए, इवेंट को बढ़ाता है.

क्लास google.assistant.library.event.RenderResponseType

किस तरह का कॉन्टेंट रेंडर करना है.

ON_RENDER_RESPONSE के साथ इस्तेमाल किया गया