Çekirdek Alt Sistemi: DictationSubsystem — MRTK3

Not

MRTK3'teki alt sistemler hakkında genel bilgi için buraya bakın.

Çekirdek Tanımları paketi DictationSubsystem, MRTK3'te dikteden sorumlu alt sistemlerin temeli olarak hizmet veren ve temel uygulamasıdır MRTKSubsystem IDictationsystem . MRTK'nin bir parçası olarak WindowsDictationSubsystem gönderilen somut uygulama ve oluşturabileceğiniz diğer olası dikte alt sistemleri bu sınıfı temel almalıdır. öğesini DictationSubsystem devralan alt sistemler, dikte oturumlarını başlatmanıza ve durdurmanıza olanak tanır ve konuşma girişi işlenirken, nihai bir sonuç tanındığında ve dikte oturumu tamamlandığında veya hatalı olduğunda tetiklenen olaylar sağlar. Dikte işlevselliğini işlemek için bu olaylara olay işleyicileri eklenebilir.

Daha ayrıntılı bilgi için kullanmak istediğiniz somut DictationSubsystem uygulamanın belgelerine bakın.

Ayarlama

Not

Bu kılavuz, yeni bir MRTK projesinde konuşma alt sistemini etkinleştirme adımlarını sağlar (diğer temel konuşmayla ilgili olmayan kurulum da vardır). Örnek projemizi kullanıyorsanız sizin için bazı adımların gerçekleştirildiğini fark edebilirsiniz.

1. Konuşma alt sistemini etkinleştirme

Proje Ayarları>MRTK3 Kullanılabilir MRTK Alt Sistemleri'ne gidin ve kullanmak istediğiniz dikte alt sistemini etkinleştirin.

2. Yapılandırma varlığı atama

Belirli alt sistemler için, normal bir şekilde performans gösterebilmesi için bir yapılandırma varlığı gerekir.

1. Kurulum 1'de etkinleştirdiğiniz alt sisteme tıklayın.
2. Sağ taraftaki Alt Sistem Ayrıntıları altında boş Configuration Asset bir yuva olup olmadığını denetleyin. Öyleyse Varlıklar -MRTK>Alt Sistemleri> Oluştur[alt sisteminizin adı] Yapılandırma'yı seçip oluşturulan yapılandırmayı yuvaya sürükleyerek yeni bir yapılandırma oluşturun.>
3. Yapılandırma yuvasının doldurulmasını sağladıktan sonra, kendi projeniz için yeni oluşturulan yapılandırmadaki ayarları değiştirin. İşiniz bittiğinde projeyi kaydetmeyi unutmayın.

3. Player Ayarları'nda uygun özelliklerin ayarlandığından emin olun

uygulamasının DictationSubsystem farklı uygulamaları farklı gerekli özelliklere sahiptir. Daha fazla bilgi için, kullanmak istediğiniz alt sistemin belgelerine bakın.

Örneğin UWP Platformu'nda kullanmak WindowsDictationSubsystem için Proje Ayarları>Oynatıcı>Yayımlama Ayarları>Özellikleri'ne gidin ve Mikrofon özelliğinin ayarlandığından emin olun.

4. Sahneyi cihazda/düzenleyicide çalıştırma

Proje artık cihazda veya düzenleyicide çalışmaya hazır olmalıdır. Diktenin düzenleyicide çalışması için konuşma gizliliği ayarlarınızı yapılandırmanız gerekebileceğini unutmayın.

DictationSubsystem Kullanma

Betikte kullanmak DictationSubsystem için, yanıtlamak istediğiniz dikte olaylarına olay işleyicileri ekleyin ve çağrısı yapın StartDictation.

// Get the first running dictation subsystem.
DictationSubsystem dictationSubsystem = XRSubsystemHelpers.GetFirstRunningSubsystem<DictationSubsystem>();

// If we found one...
if (dictationSubsystem != null)
{
    // Add event handlers to all dictation subsystem events. 
    dictationSubsystem.Recognizing += DictationSubsystem_Recognizing;
    dictationSubsystem.Recognized += DictationSubsystem_Recognized;
    dictationSubsystem.RecognitionFinished += DictationSubsystem_RecognitionFinished;
    dictationSubsystem.RecognitionFaulted += DictationSubsystem_RecognitionFaulted;

    // And start dictation
    dictationSubsystem.StartDictation();
}

Bu olay işleyicilerini, olay tetiklendiğinde gerçekleşmesini istediğiniz her şeyle uygularsınız.

• Recognizing , tanıyıcı girişi işlerken tetiklenip belirsiz bir sonuç döndürür.
• Recognized , tanıyıcı girişi tanıdığında ve son bir sonuç döndürdüğünde tetikleniyor.
• RecognitionFinished , tanıma oturumu tamamlandığında tetiklenip bir neden döndürür.
• RecognitionFaulted , tanıma hata verdiğinde (yani hata oluştuğunda) tetiklenip bir neden döndürür.

İşiniz bittiğinde, bu olay işleyicilerini kaldırın.

if (dictationSubsystem != null)
{
    dictationSubsystem.StopDictation();
    dictationSubsystem.Recognizing -= DictationSubsystem_Recognizing;
    dictationSubsystem.Recognized -= DictationSubsystem_Recognized;
    dictationSubsystem.RecognitionFinished -= DictationSubsystem_RecognitionFinished;
    dictationSubsystem.RecognitionFaulted -= DictationSubsystem_RecognitionFaulted;
}

Kullanım DictationSubsystem için tam bir örnek, örnek sahnedeki DictationHandler örnek betikte DictationExample bulunabilir.