Google Assistant Library

google.assistant.library প্যাকেজ।

ক্লাস google.assistant.library. Assistant ( প্রমাণপত্র , device_model_id )

Google সহকারী লাইব্রেরির ক্লায়েন্ট।

Google অ্যাসিস্ট্যান্টের জন্য প্রাথমিক নিয়ন্ত্রণ কার্যকারিতা এবং জীবনচক্র পরিচালনা প্রদান করে। সহকারীকে ContextManager হিসাবে ব্যবহার করা সর্বোত্তম অনুশীলন:

with Assistant(credentials, device_model_id) as assistant:

এটি অন্তর্নিহিত নেটিভ বাস্তবায়নকে সঠিকভাবে মেমরি ব্যবস্থাপনা পরিচালনা করতে দেয়।

একবার start() কল করা হলে, সহকারী বর্তমানে সহকারী বিভিন্ন রাজ্যে থাকা ইভেন্টগুলির একটি স্ট্রীম তৈরি করে, উদাহরণস্বরূপ:

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 দেখুন।

শব্দকোষ:

  • হটওয়ার্ড : নিঃশব্দ না থাকা অবস্থায় সহকারী যে বাক্যাংশটি শোনে:

    "OK Google" OR "Hey Google"

  • টার্ন : অ্যাসিস্ট্যান্ট থেকে একটি প্রতিক্রিয়া অনুসরণ করে একটি একক ব্যবহারকারীর অনুরোধ।

  • কথোপকথন : এক বা একাধিক মোড় যার ফলে সহায়কের কাছ থেকে একটি পছন্দসই চূড়ান্ত ফলাফল পাওয়া যায়:

    "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.credentials.Credentials ) – ব্যবহারকারীর Google OAuth2 শংসাপত্র।
  • device_model_id ( str ) – ডিভাইস_মডেল_আইডি যা Google-এর সাথে আপনার প্রকল্পের জন্য নিবন্ধিত ছিল। এটি একটি খালি স্ট্রিং হতে হবে না.
উত্থাপন করে:

ValueError - যদি device_model_id None বা খালি হিসাবে ছেড়ে দেওয়া হয়।

device_id

সহকারী দ্বারা তৈরি করা ডিভাইস আইডি ফেরত দেয়।

Google ডিভাইস অ্যাকশনের মতো পরিষেবাগুলি ব্যবহার করার সময় এই মানটি সার্ভারে আপনার ডিভাইসটিকে সনাক্ত করে৷ start() কল করার পরেই এই সম্পত্তিটি পূরণ করা হয়।

রিটার্ন: ডিভাইস আইডি একবার start() কল করা হয়েছে, অন্যথায় খালি স্ট্রিং।
রিটার্ন টাইপ: str
send_text_query ( প্রশ্ন )

পাঠায় |কোয়েরি | সহকারীর কাছে যেন এটি ব্যবহারকারীর দ্বারা বলা হয়েছে।

এটি একজন ব্যবহারকারীর হটওয়ার্ড বলার মতো এবং একটি প্রশ্ন তৈরি করে বা ফলো-অন প্রশ্নের উত্তর দেওয়ার মতো আচরণ করবে।

পরামিতি: query ( str ) – সহকারীকে পাঠানোর জন্য টেক্সট কোয়েরি।
set_mic_mute ( is_mute )

সহকারীকে হটওয়ার্ড শোনা থেকে থামায়।

হটওয়ার্ড শুনতে সহকারীকে অক্ষম করার অনুমতি দেয়। এটি Google হোমের পিছনের গোপনীয়তা বোতামের মতো কার্যকারিতা প্রদান করে৷

সহকারী এখনও চালু না হলে এই পদ্ধতিটি একটি নো-অপ।

পরামিতি: is_muted ( bool ) – True অ্যাসিস্ট্যান্টকে শোনা থেকে থামায় এবং False এটিকে আবার শুরু করার অনুমতি দেয়।
start ( )

সহকারী শুরু করে, যার মধ্যে একটি হটওয়ার্ড শোনা অন্তর্ভুক্ত।

একবার start() কল করা হলে, সহকারী 'ডিফল্ট' ALSA অডিও উৎস থেকে ডেটা প্রসেসিং শুরু করবে, হটওয়ার্ড শুনবে। এটি সহকারীর দ্বারা প্রদত্ত অন্যান্য পরিষেবাগুলিও শুরু করবে, যেমন টাইমার/অ্যালার্ম৷ এই পদ্ধতি শুধুমাত্র একবার বলা যেতে পারে। একবার কল করলে, __exit__ ডাকা না হওয়া পর্যন্ত সহকারী চলতে থাকবে।

রিটার্ন: ইভেন্টের একটি সারি যা সহকারী রাজ্যে পরিবর্তনের বিজ্ঞপ্তি দেয়।
রিটার্ন টাইপ: google.assistant.event.IterableEventQueue
start_conversation ( )

ম্যানুয়ালি অ্যাসিস্ট্যান্টের সাথে একটি নতুন কথোপকথন শুরু করে।

ব্যবহারকারীর বক্তৃতা রেকর্ড করা এবং Google-এ পাঠানো উভয়ই শুরু করে, অ্যাসিস্ট্যান্ট হটওয়ার্ডটি শুনলে যা ঘটে তার মতো।

সহকারী চালু না হলে বা নিঃশব্দ করা থাকলে এই পদ্ধতিটি একটি নো-অপ।

stop_conversation ( )

সহকারীর সাথে যেকোনো সক্রিয় কথোপকথন বন্ধ করে।

সহকারী ব্যবহারকারীর প্রশ্ন শুনতে বা উত্তর দিতে পারে। যদি কোন সক্রিয় কথোপকথন না থাকে তবে এটি একটি নো-অপ।

ক্লাস google.assistant.library.event. AlertEvent ( ইভেন্ট_টাইপ , আর্গস , **_ )

'alert_type'-এর পার্সিং যোগ করতে ইভেন্টকে প্রসারিত করে।

ক্লাস google.assistant.library.event. AlertType

সতর্কতার ধরন।

ON_ALERT_STARTED এবং ON_ALERT_FINISHED ইভেন্টগুলির সাথে ব্যবহার করা হয়েছে৷

ALARM = ০

একটি ইভেন্ট একটি পরম সময়ের জন্য সেট করা হয়েছে যেমন 'সোমবার 3 AM'

TIMER = 1

একটি আপেক্ষিক সময়ের জন্য সেট করা একটি ইভেন্ট যেমন 'এখন থেকে 30 সেকেন্ড'

ক্লাস google.assistant.library.event. DeviceActionEvent ( ইভেন্ট_টাইপ , আর্গস , **কোয়ার্গস )

'ক্রিয়া' বৈশিষ্ট্য যোগ করতে ইভেন্টকে প্রসারিত করে।

actions

বর্তমান ডিভাইসের জন্য কার্যকর করার জন্য কমান্ডের একটি জেনারেটর।

ক্লাস google.assistant.library.event. Event ( ইভেন্ট_টাইপ , আর্গস , **_ )

সহকারী দ্বারা তৈরি একটি ইভেন্ট।

type _

ইভেন্ট টাইপ - ইভেন্টের ধরন যা তৈরি হয়েছিল।

args

dict - এই ইভেন্টের সাথে যুক্ত আর্গুমেন্ট কী/মান জোড়া।

স্ট্যাটিক New ( ইভেন্ট_টাইপ , আর্গস , **কোয়ার্গস )

প্রয়োজনে একটি বিশেষ ইভেন্ট ক্লাস ব্যবহার করে নতুন ইভেন্ট তৈরি করুন।

পরামিতি:
  • 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

সহকারী লাইব্রেরিতে কোনো ত্রুটি হয়েছে কিনা তা নির্দেশ করে।

পরামিতি: is_fatal ( bool ) - যদি সত্য হয় তবে সহকারী পুনরুদ্ধার করতে অক্ষম হবে এবং পুনরায় চালু করা উচিত।
ON_CONVERSATION_TURN_FINISHED = 9

সহকারী বর্তমান পালা শেষ করেছে।

এতে ব্যবহারকারীর প্রশ্ন প্রক্রিয়াকরণ এবং সম্পূর্ণ প্রতিক্রিয়া বলা উভয়ই অন্তর্ভুক্ত, যদি থাকে।

পরামিতি: with_follow_on_turn ( bool ) - যদি সত্য হয়, সহকারী ব্যবহারকারীর কাছ থেকে একটি ফলো-আপ ইন্টারঅ্যাকশন আশা করছে। ব্যবহারকারীকে একটি ফলো-আপ প্রশ্নের উত্তর দেওয়ার জন্য মাইক্রোফোনটি পুনরায় খোলা হবে৷
ON_CONVERSATION_TURN_STARTED = 1

ইঙ্গিত দেয় নতুন বাঁক শুরু হয়েছে।

সহকারী বর্তমানে শুনছে, ব্যবহারকারীর প্রশ্নের জন্য অপেক্ষা করছে। সহকারীতে কল করা হটওয়ার্ড বা start_conversation() শোনার ফলাফল হতে পারে।

ON_CONVERSATION_TURN_TIMEOUT = 2

সহকারী একটি বোধগম্য প্রশ্নের জন্য অপেক্ষা করার সময় শেষ হয়েছে৷

এটি Hotword-এর একটি মিসট্রিগারের কারণে হতে পারে বা সহকারী ব্যবহারকারী কী বলেছেন তা বুঝতে পারেনি।

ON_DEVICE_ACTION = 14

নির্দেশ করে যে ডিভাইসে একটি ডিভাইস অ্যাকশন অনুরোধ পাঠানো হয়েছে।

ডিভাইস দ্বারা সমর্থিত বৈশিষ্ট্যগুলির জন্য কোনও ডিভাইস ব্যাকরণ ট্রিগার করা হলে এটি প্রেরণ করা হয়। এই ইভেন্ট টাইপের একটি বিশেষ 'ক্রিয়া' বৈশিষ্ট্য রয়েছে যা একটি পুনরাবৃত্তিকারী বা ডিভাইস অ্যাকশন কমান্ড এবং তাদের সাথে সম্পর্কিত প্যারামগুলি (যদি প্রযোজ্য হয়) প্রদান করবে।

পরামিতি: dict - একটি ডিভাইস অ্যাকশন অনুরোধের ডিকোড করা JSON পেলোড।
ON_END_OF_UTTERANCE = 3

সহকারী ব্যবহারকারীর প্রশ্নের শোনা বন্ধ করে দিয়েছে।

সহকারী ব্যবহারকারী কী বলেছে তা খুঁজে বের করতে পারেনি তবে এটি আরও অডিও ডেটার জন্য শোনা বন্ধ করে দিয়েছে।

ON_MEDIA_STATE_ERROR = 20

নির্দেশ করে যে একটি ট্র্যাক প্লে করার সময় একটি ত্রুটি ঘটেছে৷

অন্তর্নির্মিত মিডিয়া প্লেয়ারটি পরবর্তী ট্র্যাকে এড়িয়ে যাওয়ার চেষ্টা করবে বা ON_MEDIA_STATE_IDLE এ ফিরে যাওয়ার চেষ্টা করবে যদি খেলার কিছু বাকি না থাকে৷

ON_MEDIA_STATE_IDLE = 16

ইঙ্গিত করে যে খেলার কিছু নেই এবং খেলার জন্য সারিবদ্ধ কিছুই নেই৷

এই ইভেন্টটি স্টার্ট-আপে সংবাদ/পডকাস্টের জন্য Google সহকারী লাইব্রেরির অন্তর্নির্মিত মিডিয়া প্লেয়ার থেকে সম্প্রচার করা হয় এবং যখনই প্লেয়ারটি নিষ্ক্রিয় হয়ে যায় কারণ একজন ব্যবহারকারী মিডিয়া বন্ধ করেছেন বা এটিকে বিরতি দিয়েছেন এবং স্ট্রিমের সময় শেষ হয়ে গেছে।

ON_MEDIA_TRACK_LOAD = 17

নির্দেশ করে যে একটি ট্র্যাক লোড হচ্ছে কিন্তু বাজানো শুরু হয়নি৷

নতুন মেটাডেটা অ্যাসিঙ্ক্রোনাসভাবে লোড হলে এটি একাধিকবার পাঠানো হতে পারে। এটি সাধারণত ON_MEDIA_TRACK_PLAY ইভেন্ট দ্বারা অনুসরণ করা হয়৷

পরামিতি:
  • মেটাডেটা ( ডিক্ট ) -

    লোড করা ট্র্যাকের জন্য মেটাডেটা। এই সময়ের মধ্যে সমস্ত ক্ষেত্র পূরণ করা হবে না – যদি একটি ক্ষেত্র অজানা থাকে তবে এটি অন্তর্ভুক্ত করা হবে না। মেটাডেটা ক্ষেত্র অন্তর্ভুক্ত:

    অ্যালবাম(str): ট্র্যাকটি যে অ্যালবামের অন্তর্ভুক্ত তার নাম। album_art(str): অ্যালবাম শিল্পের জন্য একটি URL। artist(str): যে শিল্পী এই ট্র্যাকটি তৈরি করেছেন। duration_ms(ডবল): এই ট্র্যাকের দৈর্ঘ্য মিলিসেকেন্ডে। title(str): ট্র্যাকের শিরোনাম।
  • track_type ( MediaTrackType ) - লোড করা ট্র্যাকের ধরন।
ON_MEDIA_TRACK_PLAY = 18

নির্দেশ করে যে একটি ট্র্যাক বর্তমানে অডিও আউটপুট করছে৷

এটি শুধুমাত্র তখনই ট্রিগার হবে যখন আমরা এক রাজ্য থেকে অন্য রাজ্যে ট্রানজিশন করি, যেমন ON_MEDIA_TRACK_LOAD বা ON_MEDIA_TRACK_STOP থেকে

পরামিতি:
  • মেটাডেটা ( ডিক্ট ) -

    প্লেয়িং ট্র্যাকের জন্য মেটাডেটা। একটি ক্ষেত্র অজানা হলে এটি অন্তর্ভুক্ত করা হবে না। মেটাডেটা ক্ষেত্র অন্তর্ভুক্ত:

    অ্যালবাম(str): ট্র্যাকটি যে অ্যালবামের অন্তর্ভুক্ত তার নাম। album_art(str): অ্যালবাম শিল্পের জন্য একটি URL। artist(str): যে শিল্পী এই ট্র্যাকটি তৈরি করেছেন। duration_ms(ডবল): এই ট্র্যাকের দৈর্ঘ্য মিলিসেকেন্ডে। title(str): ট্র্যাকের শিরোনাম।
  • position_ms ( ডবল ) - শুরু থেকে মিলিসেকেন্ডে প্লেয়িং ট্র্যাকের বর্তমান অবস্থান। যদি "metadata.duration_ms" অজানা (0 তে সেট) এই ক্ষেত্রটি সেট করা হবে না।
  • track_type ( MediaTrackType ) - ট্র্যাক প্লে করার ধরন।
ON_MEDIA_TRACK_STOP = 19

ইঙ্গিত করে যে একটি পূর্বে প্লে করা ট্র্যাক বন্ধ করা হয়েছে৷

এটি সাধারণত ব্যবহারকারীর বিরতির ফলাফল; ট্র্যাকটি ON_MEDIA_TRACK_PLAY এ ফিরে যেতে পারে যদি এটি ব্যবহারকারীর দ্বারা পুনরায় চালু করা হয়।

পরামিতি:
  • মেটাডেটা ( ডিক্ট ) -

    থামানো ট্র্যাকের জন্য মেটাডেটা। একটি ক্ষেত্র অজানা হলে এটি অন্তর্ভুক্ত করা হবে না। মেটাডেটা ক্ষেত্র অন্তর্ভুক্ত:

    অ্যালবাম(str): ট্র্যাকটি যে অ্যালবামের অন্তর্ভুক্ত তার নাম। album_art(str): অ্যালবাম শিল্পের জন্য একটি URL। artist(str): যে শিল্পী এই ট্র্যাকটি তৈরি করেছেন। duration_ms(ডবল): এই ট্র্যাকের দৈর্ঘ্য মিলিসেকেন্ডে। title(str): ট্র্যাকের শিরোনাম।
  • position_ms ( ডবল ) - শুরু থেকে মিলিসেকেন্ডে একটি বন্ধ ট্র্যাকের বর্তমান অবস্থান। যদি "metadata.duration_ms" অজানা (0 তে সেট) এই ক্ষেত্রটি সেট করা হবে না।
  • track_type ( MediaTrackType ) - ট্র্যাকের ধরন বন্ধ হয়ে গেছে।
ON_MUTED_CHANGED = 13

নির্দেশ করে যে অ্যাসিস্ট্যান্ট বর্তমানে শুনছে কি না।

start() সর্বদা প্রাথমিক মান রিপোর্ট করতে একটি ON_MUTED_CHANGED তৈরি করবে।

পরামিতি: is_muted ( bool ) - যদি সত্য হয় তবে সহকারী বর্তমানে তার হটওয়ার্ড শুনছে না এবং ব্যবহারকারীর প্রশ্নের উত্তর দেবে না।
ON_NO_RESPONSE = 8

সহকারী সফলভাবে তার পালা সম্পন্ন করেছে কিন্তু বলার কিছু নেই।

ON_RECOGNIZING_SPEECH_FINISHED = 5

সহকারী চূড়ান্ত স্বীকৃত বক্তৃতা নির্ধারণ করেছে।

পরামিতি: পাঠ্য ( str ) - ব্যবহারকারীর প্রশ্নের চূড়ান্ত পাঠ্য ব্যাখ্যা।
ON_RENDER_RESPONSE = 15

ইঙ্গিত করে যে সহকারীর একটি প্রতিক্রিয়ার জন্য রেন্ডার করার জন্য পাঠ্য আউটপুট রয়েছে৷

পরামিতি:
  • টাইপ ( RenderResponseType ) - রেন্ডারের প্রতিক্রিয়ার ধরন।
  • পাঠ্য ( str ) – RenderResponseType.TEXT এর জন্য রেন্ডার করার জন্য স্ট্রিং।
ON_RESPONDING_FINISHED = 7

সহকারী ভয়েসের মাধ্যমে উত্তর দেওয়া শেষ করেছে।

ON_RESPONDING_STARTED = 6

সহকারী ভয়েসের মাধ্যমে প্রতিক্রিয়া জানাতে শুরু করেছে।

ON_RESPONDING_FINISHED না পাওয়া পর্যন্ত সহকারী সাড়া দেবে।

পরামিতি: is_error_response ( bool ) - সত্য মানে একটি স্থানীয় ত্রুটি TTS চালানো হচ্ছে, অন্যথায় অ্যাসিস্ট্যান্ট সার্ভারের প্রতিক্রিয়া দিয়ে প্রতিক্রিয়া জানায়।
ON_START_FINISHED = 0

সহকারী লাইব্রেরি শুরু করা শেষ হয়েছে।

ক্লাস google.assistant.library.event. IterableEventQueue ( সময় শেষ = 3600 )

একটি __iter__ ইন্টারফেস যোগ করতে queue.Queue প্রসারিত করে।

offer ( ইভেন্ট )

সারিতে রাখার জন্য একটি ইভেন্ট অফার করুন।

যদি সারিটি বর্তমানে পূর্ণ থাকে তবে ইভেন্টটি লগ করা হবে কিন্তু যোগ করা হবে না।

পরামিতি: ঘটনা ( ইভেন্ট ) - সারিতে যোগ করার চেষ্টা করার জন্য ইভেন্ট।
ক্লাস google.assistant.library.event. MediaStateChangeEvent ( event_type , args , **_ )

'state'-এর পার্সিং যোগ করতে ইভেন্টকে প্রসারিত করে।

ক্লাস google.assistant.library.event. MediaTrackType

একটি ON_MEDIA_TRACK_X ইভেন্টগুলির জন্য ট্র্যাকের প্রকারগুলি৷

ON_MEDIA_TRACK_LOAD , ON_MEDIA_TRACK_PLAY , এবং ON_MEDIA_TRACK_STOP এর সাথে ব্যবহৃত

CONTENT = 2

একটি আইটেমের জন্য প্রকৃত বিষয়বস্তু (সংবাদ/পডকাস্ট)।

TTS = 1

একটি আইটেমের সাথে সম্পর্কিত একটি TTS ভূমিকা বা ইন্টারস্টিশিয়াল ট্র্যাক৷

ক্লাস google.assistant.library.event. RenderResponseEvent ( event_type , args , **_ )

'response_type'-এর পার্সিং যোগ করতে ইভেন্টকে প্রসারিত করে।

ক্লাস google.assistant.library.event. RenderResponseType

রেন্ডার করার জন্য বিষয়বস্তুর প্রকার।

ON_RENDER_RESPONSE এর সাথে ব্যবহৃত