Microphone  - AS3

Mikrofonun algıladığı ses miktarı. Değerler 0 (ses algılanmaz) ile 100 (çok yüksek ses algılanır) arasındadır. Bu özelliğin değeri, Microphone.setSilenceLevel() yöntemine iletilecek iyi bir değer belirlemenize yardımcı olabilir.

Mikrofonun muted özelliği true olursa, bu özelliğin değeri her zaman -1 olur.

İlgili API Öğeleri

Ses sıkıştırmada kullanılacak codec bileşeni. Kullanılabilir codec bileşenleri Nellymoser (varsayılan) ve Speex'tir. Numaralandırma sınıfı SoundCodec, codec özeliği için geçerli olan çeşitli değerleri içerir.

Nellymoser codec bileşenini kullanırsanız, Microphone.rate() öğesini kullanarak örnek hızını ayarlayabilirsiniz. Speex codec bileşenini kullanırsanız, örnek hızı 16 kHz olarak ayarlanır.

Speex, ses etkinliği algılama (VAD) özelliğini içerir ve herhangi bir ses algılanmadığında bant genişliğini otomatik olarak azaltır. Speex codec bileşeni kullanılırken, Adobe sessizlik düzeyini 0 olarak ayarlamanızı önerir. Sessizlik düzeyini ayarlamak için, Microphone.setSilenceLevel() yöntemini kullanın.

İlgili API Öğeleri

Speex ses etkinliği algılama özelliğini etkinleştirir.

Speex codec bileşeni kullanırken kodlanan konuşma kalitesi. Olası değerler, 0 ila 10 arasındadır. Varsayılan değer 6'dır. Daha yüksek sayılar, daha yüksek kalite anlamına gelir, ancak şu tabloda da görüldüğü üzere, daha fazla band genişliği gerektirir. Listelenen bit hızı değerleri, net bit hızlarını temsil eder ve paketleme yükünü içermez.

İlgili API Öğeleri

Gelişmiş mikrofon seçeneklerini kontrol eder. Daha fazla bilgi için MicrophoneEnhancedOptions sınıfına bakın. Bu özellik geliştirilmemiş Microphone özellikleri için göz ardı edilir.

İlgili API Öğeleri

Bir pakette (mesaj) iletilen Speex konuşma karesi sayısı. Her kare 20 ms uzunluktadır. Varsayılan değer, paket başına iki karedir.

Bir mesajdaki Speex karesi ne kadar fazlaysa, gerekli bant genişliği o kadar düşük olur ancak mesaj gönderilmesinde gecikme daha uzun sürer. Speex karesinin az olması, gerekli bant genişliğini artırır ancak gecikmeyi azaltır.

Mikrofonun sinyalleri güçlendirme miktarı. Geçerli değerler 0 ile 100 arasıdır. Varsayılan değer 50'dir.

İlgili API Öğeleri

Mikrofonun Microphone.names tarafından döndürülen dizide yansıtıldığı şekildeki dizini.

İlgili API Öğeleri

isSupported özelliği, Microphone sınıfı geçerli platformda destekleniyorsa true olarak, aksi halde false olarak ayarlanır.

Kullanıcının mikrofona erişilmesini engelleyip (true) engellemediğini (false) belirtir. Bu değer değiştiğinde, bir status olayı gönderilir. Daha fazla bilgi için bkz. Microphone.getMicrophone().

İlgili API Öğeleri

Ses yakalama donanımı tarafından döndürüldüğü şekilde, geçerli ses yakalama aygıtının adı.

İlgili API Öğeleri

Tüm kullanılabilir ses yakalama aygıtlarının adlarını içeren dizeler dizisi. Bu adlar kullanıcıya Flash Player Gizlilik Ayarları panelini görüntüleme gereği olmadan döndürülür. Bu dizi, Microphone.names.length özelliği yoluyla her ses yakalama aygıtının sıfır temelli dizinini ve sistemdeki ses yakalama aygıtlarının sayısını sağlar. Daha fazla bilgi için, Array sınıfı girişine bakın.

Microphone.names özelliğinin çağrılması için donanımın kapsamlı bir incelenmesi gerekir ve dizinin oluşturulması birkaç saniye sürebilir. Çoğu durumda yalnızca varsayılan mikrofonu kullanabilirsiniz.

Not: Geçerli mikrofonun adını belirlemek için name özelliğini kullanın.

İlgili API Öğeleri

Speex kodlayıcısı için kullanılan, dB cinsinden maksimum gürültü zayıflaması (negatif sayı). Etkinleştirilirse, Speex sıkıştırmasından önce Microphone nesnesinden yakalanan sese gürültü bastırma uygulanır. Gürültü bastırmayı devre dışı bırakmak için 0 değerine ayarlayın. Gürültü bastırma, maksimum -30 dB zayıflama ile varsayılan olarak etkinleştirilir. Nellymoser codec bileşeni seçildiğinde yok sayılır.

Uygulamaya Mikrofon kullanımı izninin verilip verilmediğini belirler.

İlgili API Öğeleri

Mikrofonun kHz cinsinden ses yakalama hızı. Kabul edilebilir değerler, 5, 8, 11, 22 ve 44'tür. Ses yakalama aygıtınız 8 kHz değerini destekliyorsa, bu varsayılan değerdir. Aksi takdirde, ses yakalama aygıtınızın desteklediği 8 kHz üzerindeki bir sonraki yakalama düzeyi (genellikle 11 kHz olur) varsayılan değerdir.

Not: Aşağıdaki tabloda açıklandığı gibi, gerçek hız, rate değerinden biraz farklıdır.

İlgili API Öğeleri

Mikrofonu etkinleştirmek ve activity olayını göndermek için gerekli ses miktarı. Varsayılan değer 10'dur.

İlgili API Öğeleri

Mikrofonun ses algılamayı durdurmasıyla activity olayının çağrılması arasında geçen milisaniye sayısı. Varsayılan değer 2000'dir (2 saniye).

Bu değeri ayarlamak için Microphone.setSilenceLevel() yöntemini kullanın.

İlgili API Öğeleri

Geri döngü modunda olduğunda bu mikrofon nesnesinin sesini kontrol eder.

Eko baskılama etkinse true; değilse false değerine ayarlayın. Kullanıcı, Flash Player Mikrofon Ayarları panelinde Eko Azalt seçeneğini belirlemediyse, varsayılan olarak false değerindedir.

İlgili API Öğeleri

Akustik yankı giderme uygulayabilen gelişmiş Microphone nesnesine giden bir başvuru döndürür. Kulaklık gerektirmeyen sesli/videolu sohbet uygulamaları oluşturmak için akustik yankı gidermeyi kullanın.

Microphone.getEnhancedMicrophone() yönteminin ve Microphone.getMicrophone() yönteminin index parametresi aynı şekilde çalışır.

Bu yöntemi Android'de kullanmak için uygulama tanımlayıcısındaki Android bildirim eklentileri altında MODIFY_AUDIO_SETTINGS iznini ekleyin.

Önemli: Herhangi bir zamanda geliştirilmiş mikrofon cihazının yalnızca bir örneğine sahip olabilirsiniz. Diğer tüm Microphone örnekleri ses verisi sağlamayı durdurur ve Microphone.Unavailable code özelliğine sahip bir StatusEvent nesnesi alır. Geliştirilmiş ses başlatılamadığında bu yönteme yapılan çağrılar null değerini döndürür, Microphone.enhancedOptions için değer ayarlamanın hiçbir etkisi olmaz ve tüm mevcut Microphone örnekleri önceki gibi işlemeye devam eder.

Geliştirilmiş bir Microphone nesnesini yapılandırmak için Microphone.enhancedOptions özelliğini ayarlayın. Aşağıdaki kod yerel bir testte geliştirilmiş Microphone nesnesini ve tam iki yönlü akustik yankı gidermeyi kullanır.

	     var mic:Microphone = Microphone.getEnhancedMicrophone();
	     var options:MicrophoneEnhancedOptions = new MicrophoneEnhancedOptions();
	     options.mode = MicrophoneEnhancedMode.FULL_DUPLEX;
	     mic.enhancedOptions = options;
	     mic.setLoopBack(true);
	 

Akustik yankı giderme kullanılırken setUseEchoSuppression() yöntemi yok sayılır.

Bir SWF dosyası Microphone.getEnhancedMicrophone() tarafından döndürülen nesneye erişmeye çalıştığında (örneğin, NetStream.attachAudio() öğesini çağırdığınızda), Flash Player, kullanıcının mikrofona erişilmesine izin verip vermemeyi seçmesini sağlayan bir Gizlilik iletişim kutusunu görüntüler. (Sahne Alanı boyutunun en az 215 x 138 piksel olduğundan emin olun; bu değer, Flash Player'ın iletişim kutusunu görüntülemek için gerektirdiği minimum boyuttur.)

Parametreler

İlgili API Öğeleri

Ses yakalamak için bir Microphone nesnesine başvuru döndürür. Ses yakalamaya başlamak için, Microphone nesnesini bir NetStream nesnesine eklemeniz gerekir (bkz. NetStream.attachAudio()).

Microphone.getMicrophone() öğesine yapılan birden çok çağrı, aynı mikrofona başvurur. Böylece, kodunuz mic1 = Microphone.getMicrophone() ve mic2 = Microphone.getMicrophone() satırlarını içeriyorsa, hem mic1 hem de mic2 aynı (varsayılan) mikrofona başvurur.

Genelde index için bir değer iletmemeniz gerekir. Varsayılan mikrofona bir başvuru döndürmek için yalnızca air.Microphone.getMicrophone() öğesini çağırın. Flash Player ayarları panelinde Mikrofon Ayarları bölümünü kullanarak, kullanıcı, uygulamanın kullanması gereken varsayılan mikrofonu belirtebilir. (Kullanıcı, web tarayıcısında çalışan Flash Player içeriğini sağ tıklatarak Flash Player ayarları paneline erişir.) index için bir değer iletirseniz, kullanıcının seçtiği dışında bir mikrofona başvurabilirsiniz. index öğesini nadir durumlarda, örneğin uygulamanız aynı anda iki mikrofondan ses yakaladığında kullanabilirsiniz. Adobe AIR'de çalışan içerik de varsayılan mikrofon için Flash Player ayarını kullanır.

Geçerli Microphone nesnesinin dizin değerini almak için Microphone.index özelliğini kullanın. Daha sonra bu değeri Microphone sınıfının başka yöntemlerine iletebilirsiniz.

Bir SWF dosyası Microphone.getMicrophone() tarafından döndürülen nesneye erişmeye çalıştığında (örneğin, NetStream.attachAudio() öğesini çağırdığınızda), Flash Player, kullanıcının mikrofona erişilmesine izin verip vermemeyi seçmesini sağlayan bir Gizlilik iletişim kutusunu görüntüler. (Sahne Alanı boyutunun en az 215 x 138 piksel olduğundan emin olun; bu değer, Flash Player'ın iletişim kutusunu görüntülemek için gerektirdiği minimum boyuttur.)

Kullanıcı bu iletişim kutusuna yanıt verdiğinde, kullanıcının yanıtını belirten bir status olayı gönderilir. Kullanıcının mikrofona erişilmesine izin verip vermediğini belirlemek için Microphone.muted özelliğini de kontrol edebilirsiniz.

Microphone.getMicrophone() öğesi null değerini döndürürse, mikrofon başka bir uygulama tarafından kullanılıyordur veya sistemde yüklü mikrofon yoktur. Herhangi bir mikrofonun yüklü olup olmadığını belirlemek için Microphones.names.length öğesini kullanın. Kullanıcının Microphone.getMicrophone tarafından başvurulacak mikrofonu seçmesini sağlayan Flash Player Mikrofon Ayarları panelini görüntülemek için Security.showSettings() öğesini kullanın.

Parametreler

İlgili API Öğeleri

var mic:Microphone = Microphone.getMicrophone();
mic.setLoopBack();
mic.addEventListener(StatusEvent.STATUS, mic_status);
 
var tf:TextField = new TextField();
tf.autoSize = TextFieldAutoSize.LEFT;
tf.text = "Detecting microphone...";
addChild(tf);
 
function mic_status(evt:StatusEvent):void {
    tf.text = "Microphone is muted?: " + mic.muted;
    switch (evt.code) {
        case "Microphone.Unmuted":
            tf.appendText("\n" + "Microphone access was allowed.");
            break;
        case "Microphone.Muted":
            tf.appendText("\n" + "Microphone access was denied.");
            break;
    }
}

Uygulama için mikrofon izni ister.

Mikrofon tarafından yakalanan sesi yerel hoparlörlere yönlendirir.

Parametreler

Ses kabul edilmesi gereken minimum giriş düzeyini ve (istenirse) sessizliğin başladığını anlatan sessiz geçen zaman miktarını ayarlar.

• Mikrofonun sesi algılamasını önlemek için, silenceLevel parametresi için 100 değerini iletin; böylece hiçbir zaman activity olayı gönderilmez.
• Mikrofonun geçerli olarak algıladığı ses miktarını belirlemek için Microphone.activityLevel öğesini kullanın.

Speex, ses etkinliği algılama (VAD) özelliğini içerir ve herhangi bir ses algılanmadığında bant genişliğini otomatik olarak azaltır. Speex codec bileşeni kullanılırken, Adobe sessizlik düzeyini 0 olarak ayarlamanızı önerir.

Etkinlik algılama, ses düzeylerinin bir kişinin konuştuğunu varsaydığı zamanı algılama yeteneğidir. Birisi konuşurken, ilişkilendirilmiş ses akışını gönderme gereği olmadığından bant genişliği kaydedilebilir. Bu bilgiler, kullanıcıların kendilerinin (veya başkalarının) sessiz olduğunu bilmesini sağlamak üzere görsel geri bildirim için de kullanılabilir.

Sessizlik değerleri, doğrudan etkinlik değerlerine karşılık gelir. Tamamen sessizlik, 0 etkinlik değerine karşılık gelir. Sürekli yüksek ses (geçerli kazanım ayarı esas alınarak kaydedilebilecek en yüksek değer) 100 etkinlik değerine karşılık gelir. Kazanım yaklaşık olarak ayarlandıktan sonra, etkinlik değeriniz, konuşma anınızdaki sessizlik değerinden düşüktür; konuşurken etkinlik değeriniz sessizlik değerinizi aşar.

Bu yöntem Camera.setMotionLevel() yöntemine benzer; her iki yöntem de activity olayının ne zaman gönderileceğini belirtmek için kullanılır. Ancak bu yöntemlerin yayın akışları üzerinde çok farklı etkileri vardır:

• Camera.setMotionLevel(), hareketi algılamak için tasarlanmış olup bant genişliği kullanımını etkilemez. Bir video akışı hareketi algılamasa da video yine de gönderilir.
• Microphone.setSilenceLevel(), bant genişliğini en iyileştirmek için tasarlanmıştır. Bir ses akışı sessiz olarak değerlendirildiğinde, herhangi bir ses verisi gönderilmez. Bunun yerine, sessizliğin başladığını belirten tek bir mesaj gönderilir.

Parametreler

İlgili API Öğeleri

Ses codec bileşeninin eko baskılama özelliğinin kullanılıp kullanılmayacağını belirtir. Kullanıcı, Flash Player Mikrofon Ayarları panelinde Eko Azalt seçeneğini belirlemediyse, varsayılan olarak false değerindedir.

Eko baskılama, hoparlörden çıkan ses aynı sistemdeki mikrofon tarafından alındığında ortaya çıkan ses geri bildiriminin etkisini azaltma eylemidir. (Bu, geri bildirimi tamamen yok eden akustik yankı gidermeden farklıdır. Akustik yankı gidermeyi kullanmak için getEnhancedMicrophone() yöntemini kullandığınızda setUseEchoSuppression() yöntemi yok sayılır.)

Genellikle, yakalanmakta olan ses, kulaklıklı mikrofon seti yerine hoparlörlerden çalınırken eko baskılama önerilir. SWF dosyanız kullanıcıların ses çıkış aygıtını belirtmesine izin veriyorsa, hoparlör kullandıklarını ve mikrofonu da kullanacaklarını belirttiklerinde Microphone.setUseEchoSuppression(true) öğesini çağırmak isteyebilirsiniz.

Kullanıcılar, Flash Player Mikrofon Ayarları panelinde de bu ayarları yapabilir.

Parametreler

İlgili API Öğeleri

İki dinleyici activity ve status olaylarını dinler. activity olayı, oturumun (varsa) başında ve sonunda gönderilir ve olay hakkında bilgileri izleyen activityHandler() yöntemi tarafından yakalanır. Takılı mikrofon nesnesi herhangi bir durum bilgisi bildirirse, status olayı gönderilir; statusHandler() yöntemi kullanılarak yakalanır ve izlenir.

Not: Bu örneğin doğru şekilde çalışması için bir mikrofonun bilgisayarınıza takılı olması gerekir.

package {
    import flash.display.Sprite;
    import flash.events.*;
    import flash.media.Microphone;
    import flash.system.Security;

    public class MicrophoneExample extends Sprite {
        public function MicrophoneExample() {
            var mic:Microphone = Microphone.getMicrophone();
            Security.showSettings("2");
            mic.setLoopBack(true);
                    
            if (mic != null) {
                mic.setUseEchoSuppression(true);
                mic.addEventListener(ActivityEvent.ACTIVITY, activityHandler);
                mic.addEventListener(StatusEvent.STATUS, statusHandler);
            }
        }

        private function activityHandler(event:ActivityEvent):void {
            trace("activityHandler: " + event);
        }

        private function statusHandler(event:StatusEvent):void {
            trace("statusHandler: " + event);
        }
    }
}