ConversationalAgentSession Kelas

Definisi

Ruang nama:

Windows.ApplicationModel.ConversationalAgent

Saluran komunikasi antara asisten digital dan platform Agen Percakapan Windows.

public ref class ConversationalAgentSession sealed : IClosable

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 524288)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
class ConversationalAgentSession final : IClosable

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 524288)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public sealed class ConversationalAgentSession : System.IDisposable

Public NotInheritable Class ConversationalAgentSession
Implements IDisposable

Warisan

Object Platform::Object IInspectable ConversationalAgentSession

Atribut

ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Penerapan

IClosable IDisposable

Persyaratan Windows

Rangkaian perangkat	Windows 10, version 1903 (diperkenalkan dalam 10.0.18362.0)
API contract	Windows.Foundation.UniversalApiContract (diperkenalkan dalam v8.0)

Keterangan

ConversationalAgentSession biasanya dibuat melalui aktivasi suara ketika ucapan kata kunci seperti "Hey Cortana" atau "Alexa" dikenali.

ConversationalAgentSession dapat dibuat dengan berbagai cara lain, termasuk Bluetooth (ketika ucapan kata kunci ditransmisikan melalui headset atau mikrofon), akselerator keyboard sistem (seperti Win+C untuk Cortana), dan inisiasi interaksi ucapan dari dalam aplikasi Anda (mungkin melalui semacam UI press-to-talk).

Properti

AgentState	Mendapatkan status asisten digital.
IsIndicatorLightAvailable	Mendapatkan apakah lampu indikator tersedia.
IsInterrupted	Mendapatkan apakah ConversationalAgentSession sedang terganggu.
IsInterruptible	Mendapatkan apakah ConversationalAgentSession dapat terganggu.
IsScreenAvailable	Mendapatkan apakah layar dapat dinyalakan.
IsUserAuthenticated	Mendapatkan apakah pengguna diautentikasi (misalnya, perangkat dikunci).
IsVoiceActivationAvailable	Mendapatkan apakah asisten digital dapat diaktifkan oleh input ucapan.
Signal	Sinyal yang mengaktifkan asisten digital, seperti ucapan kata kunci, transmisi Bluetooth, akselerator keyboard sistem, pengenalan ucapan dalam aplikasi, atau suara lainnya (slam pintu, detektor asap).

Metode

Close()	Mengakhiri ConversationalAgentSession.
CreateAudioDeviceInputNode(AudioGraph)	Secara sinkron membuat simpul input grafik audio. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan CreateAudioDeviceInputNodeAsync sebagai gantinya.
CreateAudioDeviceInputNodeAsync(AudioGraph)	Secara asinkron membuat simpul input grafik audio.
Dispose()	Melakukan tugas yang ditentukan aplikasi yang terkait dengan membebaskan, melepaskan, atau mereset sumber daya yang tidak terkelola.
GetAudioCaptureDeviceId()	Secara sinkron mengambil ID perangkat untuk perangkat input ucapan saat ini. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetAudioCaptureDeviceIdAsync sebagai gantinya.
GetAudioCaptureDeviceIdAsync()	Secara asinkron mengambil ID perangkat untuk perangkat input ucapan saat ini.
GetAudioClient()	Secara sinkron mengambil objek IAudioClient yang membuat dan menginisialisasi aliran audio antara aplikasi Anda dan perangkat penyajian audio. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetAudioClientAsync sebagai gantinya.
GetAudioClientAsync()	Secara asinkron mengambil objek IAudioClient yang membuat dan menginisialisasi aliran audio antara aplikasi Anda dan perangkat penyajian audio.
GetAudioRenderDeviceId()	Secara sinkron mengambil ID perangkat untuk perangkat output ucapan saat ini. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetAudioRenderDeviceIdAsync sebagai gantinya.
GetAudioRenderDeviceIdAsync()	Secara asinkron mengambil ID perangkat untuk perangkat output ucapan saat ini.
GetCurrentSessionAsync()	Secara asinkron mengambil referensi ke ConversationalAgentSession saat ini.
GetCurrentSessionSync()	Secara sinkron mengambil referensi ke ConversationalAgentSession saat ini. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetCurrentSessionAsync sebagai gantinya.
GetMissingPrerequisites()	Mendapatkan prasyarat yang hilang yang diperlukan agar aktivasi suara tersedia dan berfungsi dengan baik.
GetMissingPrerequisitesAsync()	Mendapatkan prasyarat yang hilang untuk aktivasi suara agar tersedia dan berfungsi dengan baik.
GetSignalModelId()	Mengambil pengidentifikasi model unik Signal yang mengaktifkan agen percakapan. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetSignalModelIdAsync sebagai gantinya.
GetSignalModelIdAsync()	Secara asinkron mengambil pengidentifikasi model unik Signal yang mengaktifkan agen percakapan.
GetSupportedSignalModelIds()	Mengambil kumpulan pengidentifikasi model Sinyal unik yang didukung oleh agen percakapan. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan GetSupportedSignalModelIdsAsync sebagai gantinya.
GetSupportedSignalModelIdsAsync()	Secara asinkron mengambil koleksi pengidentifikasi model Sinyal unik yang didukung oleh agen percakapan.
RequestActivation(ConversationalAgentActivationKind)	Meminta agar asisten digital diaktifkan ke latar depan.
RequestActivationAsync(ConversationalAgentActivationKind)	Secara asinkron meminta agar asisten digital diaktifkan ke latar depan.
RequestAgentStateChange(ConversationalAgentState)	Secara sinkron meminta perubahan status untuk ConversationalAgentSession saat ini. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan RequestAgentStateChangeAsync sebagai gantinya.
RequestAgentStateChangeAsync(ConversationalAgentState)	Secara asinkron meminta perubahan status untuk ConversationalAgentSession saat ini.
RequestForegroundActivation()	Secara sinkron meminta agar asisten digital diaktifkan ke latar depan. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan RequestForegroundActivationAsync sebagai gantinya.
RequestForegroundActivationAsync()	Secara asinkron meminta agar asisten digital diaktifkan ke latar depan.
RequestInterruptible(Boolean)	Secara sinkron meminta agar ConversationalAgentSession ini dapat diinterupsi jika kata kunci untuk asisten digital lain terdeteksi. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan RequestInterruptibleAsync sebagai gantinya.
RequestInterruptibleAsync(Boolean)	Secara asinkron meminta agar ConversationalAgentSession ini dapat diinterupsi jika kata kunci untuk asisten digital lain terdeteksi.
SetSignalModelId(UInt32)	Menetapkan pengidentifikasi unik ke model yang mewakili sinyal audio aktivasi untuk agen percakapan. Penting Untuk menghindari kemungkinan masalah konkurensi, sebaiknya gunakan SetSignalModelIdAsync sebagai gantinya.
SetSignalModelIdAsync(UInt32)	Secara asinkron menetapkan pengidentifikasi unik ke model yang mewakili sinyal audio aktivasi untuk agen percakapan.
SetSupportLockScreenActivation(Boolean)	Mengaktifkan atau menonaktifkan dukungan untuk aktivasi layar kunci agen percakapan.
SetSupportLockScreenActivationAsync(Boolean)	Secara asinkron memungkinkan atau menonaktifkan dukungan untuk aktivasi layar kunci agen percakapan.

Acara

SessionInterrupted	Terjadi ketika sinyal aktivasi asisten digital lain telah terdeteksi.
SignalDetected	Terjadi ketika Sinyal untuk mengaktifkan asisten digital terdeteksi.
SystemStateChanged	Terjadi ketika sistem atau pengguna mengubah pengaturan yang membatasi kemampuan asisten digital untuk melakukan satu atau beberapa tindakan.