Dizin
EmbeddedAssistant
(arayüz)AudioInConfig
(message)AudioInConfig.Encoding
(enum)AudioOut
(message)AudioOutConfig
(message)AudioOutConfig.Encoding
(enum)ConverseConfig
(message)ConverseRequest
(message)ConverseResponse
(message)ConverseResponse.EventType
(enum)ConverseResult
(message)ConverseResult.MicrophoneMode
(enum)ConverseState
(message)
EmbeddedAssistant
Google Asistan API'sini uygulayan hizmet.
Converse | |
---|---|
Yerleşik asistan hizmetiyle bir görüşme başlatır veya görüşmeye devam eder. Her arama, bir gidiş dönüş gerçekleştirerek hizmete bir sesli istek gönderir ve sesli yanıtı alır. Ses gönderirken Bir ileti dizisi, her biri akışlı birkaç istek ve yanıttan oluşan bir veya daha fazla gRPC bağlantısıdır. Örneğin, kullanıcı Alışveriş listeme ekle diyor ve asistan, Ne eklemek istiyorsunuz? diye yanıt veriyor. İlk gRPC mesajındaki akışlı istek ve yanıtların sırası şöyle olabilir:
Daha sonra kullanıcı bagel diyor ve asistan, Tamam, alışveriş listenize bagel ekledim yanıtı verir. Bu, yine akışlı istek ve yanıtlarla birlikte
Yanıtların tam sırası garanti edilmese de, sıralı ConverseResponse.audio_out mesajları her zaman sesin sıralı bölümlerini içerir.
|
AudioInConfig
Sonraki isteklerde sağlanacak audio_in
verilerinin nasıl işleneceğini belirtir. Önerilen ayarlar için Google Asistan gRPC API en iyi uygulamalarına bakın.
Alanlar | |
---|---|
encoding |
Zorunlu Tüm |
sample_rate_hertz |
Zorunlu Tüm |
Kodlama
Sesli mesajda gönderilen verilerin ses kodlaması. Ses tek kanallı (mono) olmalıdır. Yalnızca "en-US" dili desteklenir.
Sıralamalar | |
---|---|
ENCODING_UNSPECIFIED |
Belirtilmedi. google.rpc.Code.INVALID_ARGUMENT sonucunu döndürür. |
LINEAR16 |
Sıkıştırılmamış 16 bit imzalı küçük uçlu örnekler (Doğrusal PCM). Bu kodlama başlık içermez, yalnızca işlenmemiş ses baytlarını içerir. |
FLAC |
FLAC (Ücretsiz Kayıpsız Ses Codec'i) önerilen kodlamadır, çünkü kayıpsızdır, bu nedenle tanımanın güvenliği ihlal edilmez ve LINEAR16 'in yalnızca yarısı kadar bant genişliği gerektirir. Bu kodlama, FLAC akış başlığını ve ardından ses verilerini içerir. 16 bit ve 24 bit örnekleri destekler, ancak STREAMINFO ürünündeki tüm alanlar desteklenmez. |
AudioOut
Asistanın sorguya verdiği yanıtı içeren ses. Sıralı ses verisi parçaları, sıralı ConverseResponse
mesajlarıyla alınır.
Alanlar | |
---|---|
audio_data |
Yalnızca çıkış Asistanın sorguya verdiği yanıtı içeren ses verileri. Sıralı ses verisi parçaları, sıralı |
AudioOutConfig
Sunucunun audio_out
mesajlarını döndürdüğünde kullanması istenen biçimi belirtir.
Alanlar | |
---|---|
encoding |
Zorunlu Tüm |
sample_rate_hertz |
Zorunlu |
volume_percentage |
Gerekli Cihazın ses çıkışının geçerli ses ayarı. Geçerli değerler 1 ile 100 arasındadır (%1 ile %100'e karşılık gelir). |
Kodlama
Sesli mesajda döndürülen verilerin ses kodlaması. Tüm kodlamalar, aşağıda belirtilenler dışında üstbilgi içermeyen ham ses baytlarıdır.
Sıralamalar | |
---|---|
ENCODING_UNSPECIFIED |
Belirtilmedi. google.rpc.Code.INVALID_ARGUMENT sonucunu döndürür. |
LINEAR16 |
Sıkıştırılmamış 16 bit imzalı küçük uçlu örnekler (Doğrusal PCM). |
MP3 |
MP3 ses kodlaması. Örnek hızı, yüke kodlanır. |
OPUS_IN_OGG |
Ogg kapsayıcısına sarılmış Opus kodlu ses. Sonuç, Android'de ve bazı tarayıcılarda (ör. Chrome) yerel olarak oynatılabilen bir dosya olacaktır. Aynı bit hızı kullanıldığında, kodlama kalitesi MP3'ten oldukça yüksektir. Örnek hızı, yüke kodlanır. |
ConverseConfig
ConverseRequest
mesajlarının nasıl işleneceğini belirtir.
Alanlar | |
---|---|
audio_in_config |
Gerekli: Sonraki gelen sesin nasıl işleneceğini belirtir. |
audio_out_config |
Gerekli Döndürülecek sesin nasıl biçimlendirileceğini belirtir. |
converse_state |
Gerekli Mevcut iletişim kutusu durumunu gösterir. |
ConverseRequest
İstemci tarafından gönderilen üst düzey mesaj. İstemcilerin en az iki ve genellikle birden fazla ConverseRequest
mesajı göndermesi gerekir. İlk mesaj bir config
mesajı içermeli ve audio_in
verisi içermemelidir. Sonraki tüm mesajlar audio_in
verisi içermeli ve config
mesajı içermemelidir.
Alanlar | ||
---|---|---|
converse_request alanı. Her ConverseRequest için bu alanlardan tam olarak biri belirtilmelidir. converse_request şunlardan yalnızca biri olabilir: |
||
config |
|
|
audio_in |
Tanınacak ses verileri. Sıralı ses verisi parçaları, sıralı |
ConverseResponse
İstemci tarafından alınan üst düzey mesaj. Bir veya daha fazla ConverseResponse
mesajından oluşan bir dizi istemciye geri aktarılır.
Alanlar | ||
---|---|---|
converse_response alanı. Her bir ConverseResponse için bu alanlardan tam olarak biri doldurulur. converse_response şunlardan yalnızca biri olabilir: |
||
error |
Yalnızca çıkış Ayarlanırsa işlemle ilgili hatayı belirten bir |
|
event_type |
Yalnızca çıkış Etkinliğin türünü belirtir. |
|
audio_out |
Yalnızca çıkış Asistan'ın sorguya verdiği yanıtı içeren ses. |
|
result |
Yalnızca çıkış Kullanıcının sözlü sorgusunun anlamsal sonucu. |
EventType
Etkinliğin türünü gösterir.
Sıralamalar | |
---|---|
EVENT_TYPE_UNSPECIFIED |
Etkinlik belirtilmedi. |
END_OF_UTTERANCE |
Bu etkinlik, sunucunun, kullanıcının konuşma ifadesinin sonunu algıladığını ve başka konuşma beklemediğini gösterir. Bu nedenle, sunucu ek ses işlemez (ancak daha sonra ek sonuçlar döndürebilir). İstemcinin ek ses verileri göndermeyi durdurması, gRPC bağlantısını yarıya kadar kapatması ve sunucu gRPC bağlantısını kapatana kadar ek sonuçlar için beklemesi gerekir. |
ConverseResult
Kullanıcının sözlü sorgusunun anlamsal sonucu.
Alanlar | |
---|---|
spoken_request_text |
Yalnızca çıkış: Kullanıcının söylediklerinin tanınan transkripti. |
spoken_response_text |
Yalnızca çıkış: Asistanın sözlü yanıtının metni. Bu değer, yalnızca IFTTT işlemi için döndürülür. |
conversation_state |
Sonraki |
microphone_mode |
Yalnızca çıkış Bu |
volume_percentage |
Yalnızca çıkış Güncellenen ses düzeyi. "Sesi artır" veya "Ses seviyesi 4'ü ayarla" gibi bir sesli komut algılanmadığında değer 0 olur veya atlanır (değişiklik olmadığını gösterir). Bu durumda, değer 1 ile 100 arasında olur (%1 ile %100 arasındaki yeni ses düzeyine karşılık gelir). Genellikle, bir istemci |
MicrophoneMode
Converse
RPC tamamlandıktan sonra mikrofonun olası durumları.
Sıralamalar | |
---|---|
MICROPHONE_MODE_UNSPECIFIED |
Mod belirtilmedi. |
CLOSE_MICROPHONE |
Hizmet, kullanıcıdan ek bir soru beklemiyor. Kullanıcı yeniden etkinleştirene kadar mikrofon kapalı kalmalıdır. |
DIALOG_FOLLOW_ON |
Hizmet, kullanıcıdan ek bir soru beklemektedir. AudioOut çalma işlemi tamamlandığında (yeni sesi göndermek için yeni bir Converse RPC çağrısı başlatarak) mikrofon yeniden açılmalıdır. |
ConverseState
Mevcut iletişim kutusu durumu hakkında bilgi sağlar.
Alanlar | |
---|---|
conversation_state |
Zorunlu Önceki |