Bagikan melalui


ConversationalAgentSession Kelas

Definisi

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
Penerapan

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.

Berlaku untuk