ConversationalAgentSession Kelas
Definisi
Penting
Beberapa informasi terkait produk prarilis yang dapat diubah secara signifikan sebelum dirilis. Microsoft tidak memberikan jaminan, tersirat maupun tersurat, sehubungan dengan informasi yang diberikan di sini.
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
- 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. |