Capabilities  - AS3

Kullanıcı kamera ve mikrofonuna erişimin yönetici tarafından yasaklanmış (true) veya izin verilmiş (false) olduğunu belirtir. Sunucu dizesi AVD olur.

Adobe AIR™'deki içerik için bu özellik, yalnızca uygulama güvenlik sanal alanı dışındaki güvenlik sanal alanlarında bulunan içerik için geçerlidir. Uygulama güvenlik sanal alanındaki içerik her zaman kullanıcının kamerasına ve mikrofonuna erişebilir.

İlgili API Öğeleri

Geçerli CPU mimarisini belirtir. cpuArchitecture özelliği aşağıdaki dizeleri döndürebilir: "PowerPC", "x86", "SPARC", ve "ARM". Sunucu dizesi ARCH olur.

Sistemin, erişilebilirlik yardımları ile iletişimi destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi ACC olur.

İlgili API Öğeleri

Sistemin ses yeteneklerine sahip olup olmadığını belirtir. Bu özellik, her zaman true olur. Sunucu dizesi A olur.

Sistemin, örneğin bir mikrofondan gelen bir ses akışını kodlayıp (true) kodlayamayacağını (false) belirtir. Sunucu dizesi AE olur.

Sistemin gömülü videoyu destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi EV olur.

Sistemde bir girdi yöntemi düzenleyicisinin yüklü olup (true) olmadığını (false) belirtir. Sunucu dizesi IME olur.

İlgili API Öğeleri

Sistemin bir MP3 kod çözücüye sahip olup (true) olmadığını (false) belirtir. Sunucu dizesi MP3 olur.

Sistemin yazdırma işlevini destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi PR olur.

Sistemin ekran yayınlama uygulamaları geliştirmesinin Flash Media Server üzerinden çalıştırılmasını destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi SB olur.

Sistemin Flash Media Server üzerinde çalıştırılan ekran yayınlama uygulamalarının oynatımını destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi SP olur.

Sistemin ses akışı oynatıp (true) oynatamayacağını (false) belirtir. Sunucu dizesi SA olur.

Sistemin video akışı oynatıp (true) oynatamayacağını (false) belirtir. Sunucu dizesi SV olur.

Sistemin NetConnection üzerinden yerel SSL soketlerini destekleyip (true) desteklemediğini (false) belirtir. Sunucu dizesi TLS olur.

İlgili API Öğeleri

Sistemin, örneğin bir web kamerasından gelen bir video akışını kodlayıp (true) kodlayamayacağını (false) belirtir. Sunucu dizesi VE olur.

Sistemin özel hata ayıklama sürümü (true) mü, normal sürüm (false) mü olduğunu belirtir. Sunucu dizesi DEB olur. Flash Player'ın veya AIR Hata Ayıklama Başlatıcısı'nın (ADL) hata ayıklama sürümünde çalıştırılırken bu özellik true değerine ayarlanır.

Flash çalışma zamanının Actobat 9.0 veya daha sonraki bir sürümünde açık olan bir PDF dosyasına gömülü olup (true) olmadığını (false) belirtir.

İçeriğin üzerinde çalıştığı sistemin dil kodunu belirtir. Dil, ISO 639-1'den iki küçük harften oluşan dil kodu olarak belirtilir. Çince için, ISO 3166'daki ilave, iki büyük harften oluşan ülke kodu, Basitleştirilmiş ve Geleneksel Çince arasındaki farkı gösterir. Dil kodları, dilin İngilizce adına dayanarak oluşturulur: örneğin hu, Macarca'yı belirtir.

İngilizce sistemlerde bu özellik yalnızca dil kodunu (en) döndürür, ülke kodunu döndürmez. Microsoft Windows sistemlerinde bu özellik, tüm menüler için kullanılan dile, iletişim kutularına, hata mesajlarına ve yardım dosyalarına ait kullanıcı arabirimi (UI) dilini döndürür. Şu tablo, olası değerleri listeler:

Not: Capabilities.language özelliği, bu listedeki olası değerlerle sınırlıdır. Bu sınırlamadan dolayı, Adobe AIR uygulamaları, sistemin birincil kullanıcı arabirimi dilini belirlemek için Capabilities.languages dizisindeki birinci öğeyi kullanmalıdır.

Sunucu dizesi L olur.

İlgili API Öğeleri

package {
    import flash.display.Sprite;
    import flash.text.TextField;
    import flash.text.TextFieldAutoSize;
    import flash.system.Capabilities;

    public class Capabilities_languageExample extends Sprite {

        public function Capabilities_languageExample()  {
            var myTextField:TextField = new TextField();         
            myTextField.x = 10;
            myTextField.y = 10;
            myTextField.background = true;
            myTextField.autoSize = TextFieldAutoSize.LEFT;
            
            var greetingEnglish:String = "Hello World";
            var greetingGerman:String = "Hallo Welt";
            var greetingFrench:String = "Bonjour Monde";
            var greetingSpanish:String = "Hola Mundo";

            var lang:String = Capabilities.language;
                         
            switch (lang) {
                case "en":
                    myTextField.text = greetingEnglish;
                    break;
                case "de":
                    myTextField.text = greetingGerman;
                    break;
                case "fr":
                    myTextField.text = greetingFrench;
                    break;
                case "es":
                    myTextField.text = greetingSpanish;
                    break;
                default:
                    myTextField.text = "Sorry your system's language is not supported at this time.";               
            }
             
            this.addChild(myTextField);
        }
    }
}

İşletim sistemi tarafından ayarlandığı şekilde, kullanıcının tercih ettiği kullanıcı arabirimi dilleri hakkında bilgi içeren dizelerden oluşan bir dizi. Bu dizeler, RFC4646 (http://www.ietf.org/rfc/rfc4646.txt) tarafından tanımlanan language etiketlerini içerir (ve varsa komut dosyası ve bölge bilgilerini) ve ayraç olarak kısa çizgi kullanır (örneğin, "tr-TR" veya "ja-JP"). Diller, işletim sistemi ayarları tarafından belirlendiği şekilde tercih sırasına göre dizide listelenir.

İşletim sistemleri, yerel ayar dizelerinde döndürülen bölge bilgilerinde farklılaşır. Bir işletim sistemi "en-us" döndürürken, diğer işletim sistemi "en" döndürebilir.

Döndürülen dizideki birinci giriş genellikle, Capabilities.language özelliğiyle aynı birincil dil kimliğine sahip olur. Örneğin, Capabilities.languages[0] öğesi "tr-TR" olarak ayarlanırsa, language özelliği de "tr" olarak ayarlanır. Ancak, Capabilities.language özelliği "xu" olarak ayarlanırsa (bilinmeyen bir dili belirtir), bu dizideki birinci öğe farklı olacaktır. Bu nedenle, Capabilities.languages[0], Capabilities.language öğesinden daha doğru olabilir.

Sunucu dizesi LS olur.

Kullanıcının sabit diskine okuma erişiminin yönetici tarafından yasaklanmış (true) veya izin verilmiş (false) olduğunu belirtir. Adobe AIR'deki içerik için bu özellik, yalnızca uygulama güvenlik sanal alanı dışındaki güvenlik sanal alanlarında bulunan içerik için geçerlidir. (Uygulama güvenlik sanal alanındaki içerik her zaman dosya sisteminden okunabilir.) Bu özellik true olursa, Flash Player, dosyaları (Flash Player'ın birlikte başlatıldığı ilk dosya dahil) kullanıcının sabit diskinden okuyamaz. Bu özellik true olursa, uygulama güvenlik sanal alanı dışındaki AIR içeriği, kullanıcının sabit diskinden dosyaları okuyamaz. Örneğin, bu özelliğin true değerine ayarlanması durumunda, yükleme yöntemlerini kullanarak kullanıcının sabit diskindeki bir dosyayı okuma girişimleri başarısız olur.

Bu özelliğin true değerine ayarlanması durumunda, çalışma zamanı paylaşılan kütüphanelerin okunması da engellenir, ancak yerel olarak paylaşılan nesnelerin okunmasına bu özelliğin değerinden bağımsız olarak izin verilir.

Sunucu dizesi LFD olur.

İlgili API Öğeleri

Çalıştırılan Flash Player veya AIR çalışma zamanı sürümünün üreticisini "Adobe OSName" biçiminde belirtir. OSName değeri, "Windows", "Macintosh", "Linux" veya başka bir işletim sistemi adı olabilir. Sunucu dizesi M olur.

Daha belirli bir yetenek özelliği mevcutsa bir yeteneği işletim sistemini temel almak için Capabilities.manufacturer öğesini kullanmayın. Bir yeteneği işletim sistemini temel alarak belirlemek, bir uygulama tüm potansiyel hedef işletim sistemlerini dikkate almazsa sorunlara yol açabileceğinden kötü bir fikirdir. Onun yerine, test ettiğiniz yeteneğe karşılık gelen özelliği kullanın. Daha fazla bilgi için Capabilities sınıfı açıklamasına bakın.

İstemci donanımının desteklediği en yüksek H.264 Düzey IDC'yi alır. Bu düzeyde çalışan medyanın çalışması garantilenir; ancak en yüksek düzeyde çalışan medya, en yüksek kalitede çalışmayabilir. Bir istemcinin yeteneklerini hedeflemeye çalışan sunucular için bu özellik kullanışlıdır. Bir sunucu bu özelliği kullanarak istemciye gönderilecek video düzeyini belirleyebilir.

Sunucu dizesi ML olur.

Geçerli işletim sistemini belirtir. os özelliği aşağıdaki dizeleri döndürebilir:

Sunucu dizesi OS olur.

Daha belirli bir yetenek özelliği mevcutsa bir yeteneği işletim sistemini temel almak için Capabilities.manufacturer öğesini kullanmayın. Bir yeteneği işletim sistemini temel alarak belirlemek, bir uygulama tüm potansiyel hedef işletim sistemlerini dikkate almazsa sorunlara yol açabileceğinden kötü bir fikirdir. Onun yerine, test ettiğiniz yeteneğe karşılık gelen özelliği kullanın. Daha fazla bilgi için Capabilities sınıfı açıklamasına bakın.

Ekranın piksel en boy oranını belirtir. Sunucu dizesi AR olur.

Çalışma zamanı ortamının türünü belirtir. Bu özellik, aşağıdaki değerlerden birine sahip olabilir:

• Microsoft Internet Explorer tarafından kullanılan Flash Player ActiveX denetimi "ActiveX"
• Adobe AIR çalışma zamanı için "Desktop" (Capabilities.playerType öğesi "PlugIn" olarak ayarlı olan bir HTML sayfası tarafından yüklenmiş içerik dışında)
• Harici Flash Player için veya test modunda "External"
• Flash Player tarayıcı eklentisi için (ve bir AIR uygulamasında bir HTML sayfası tarafından yüklenen SWF içeriği için) "PlugIn"
• Tek başına çalışabilen Flash Player için "StandAlone"

Sunucu dizesi PT olur.

Ekran rengini belirtir. Bu özellik, "color", "gray" (gri tonlamalı için) veya "bw" (siyah beyaz için) değerine sahip olabilir. Sunucu dizesi COL olur.

Ekranın inç başına nokta (dpi) çözünürlüğünü piksel olarak belirtir. Sunucu dizesi DP olur.

Ekranın maksimum yatay çözünürlüğünü belirtir. Sunucu dizesi R olur. (Ekranın hem genişliğini hem de yüksekliğini döndürür.) Bu özellik, bir kullanıcının ekran çözünürlüğüyle güncelleştirme yapmaz, bunun yerine yalnızca Flash Player'ın veya bir Adobe AIR uygulamasının başlatıldığı çözünürlüğü gösterir. Ayrıca, değer yalnızca birincil ekranı belirtir.

Ekranın maksimum dikey çözünürlüğünü belirtir. Sunucu dizesi R olur. (Ekranın hem genişliğini hem de yüksekliğini döndürür.) Bu özellik, bir kullanıcının ekran çözünürlüğüyle güncelleştirme yapmaz, bunun yerine yalnızca Flash Player'ın veya bir Adobe AIR uygulamasının başlatıldığı çözünürlüğü gösterir. Ayrıca, değer yalnızca birincil ekranı belirtir.

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}

Her Capabilities özelliğine değer belirleyen URL olarak kodlanmış bir dize.

Şu örnek, URL olarak kodlanmış bir dizeyi gösterir:

A=t&SA=t&SV=t&EV=t&MP3=t&AE=t&VE=t&ACC=f&PR=t&SP=t&
	 SB=f&DEB=t&V=WIN%208%2C5%2C0%2C208&M=Adobe%20Windows&
	 R=1600x1200&DP=72&COL=color&AR=1.0&OS=Windows%20XP&
	 L=en&PT=External&AVD=f&LFD=f&WD=f

Sistemin 32 bit işlemleri çalıştırmayı destekleyip desteklemediğini belirtir. Sunucu dizesi PR32 olur.

Sistemin 64 bit işlemleri çalıştırmayı destekleyip desteklemediğini belirtir. Sunucu dizesi PR64 olur.

Varsa, desteklenen dokunmatik ekran türünü belirtir. Değerler flash.system.TouchscreenType sınıfında tanımlanır.

İlgili API Öğeleri

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var capabilitiesTouchScreenTypeTxt:TextField = new TextField();
capabilitiesTouchScreenTypeTxt.width = 300;
capabilitiesTouchScreenTypeTxt.border = true;

addChild(capabilitiesTouchScreenTypeTxt);

addEventListener(MouseEvent.CLICK, getScreenKeyboardType);

function getScreenKeyboardType(e:MouseEvent):void{
    capabilitiesTouchScreenTypeTxt.text= "flash.system.Capabilities.touchscreenType is : " + flash.system.Capabilities.touchscreenType;
}

Flash Player veya Adobe^® AIR^® platform ve sürüm bilgilerini belirtir. Sürüm numarasının biçimi şu şekildedir: platform majorVersion,minorVersion,buildNumber,internalBuildNumber. Platform için olası değerler "WIN", ` "MAC", "LNX" ve "AND" şeklindedir. Bazı sürüm bilgisi örnekleri şu şekildedir:

	 WIN 9,0,0,0  // Flash Player 9 for Windows
	 MAC 7,0,25,0   // Flash Player 7 for Macintosh
	 LNX 9,0,115,0  // Flash Player 9 for Linux
	 AND 10,2,150,0 // Flash Player 10 for Android
	 

Daha belirli bir yetenek özelliği mevcutsa bir yeteneği işletim sistemini temel almak için Capabilities.version öğesini kullanmayın. Bir yeteneği işletim sistemini temel alarak belirlemek, bir uygulama tüm potansiyel hedef işletim sistemlerini dikkate almazsa sorunlara yol açabileceğinden kötü bir fikirdir. Onun yerine, test ettiğiniz yeteneğe karşılık gelen özelliği kullanın. Daha fazla bilgi için Capabilities sınıfı açıklamasına bakın.

Sunucu dizesi V olur.

import flash.events.*;
import flash.display.*;
import flash.system.Capabilities;
import flash.text.TextField;

var screenInfoTxt:TextField = new TextField();
screenInfoTxt.x = 30;
screenInfoTxt.y = 50;
screenInfoTxt.width = 300;
screenInfoTxt.height = 100;
screenInfoTxt.border = true;

addChild(screenInfoTxt);

addEventListener(MouseEvent.CLICK, getScreenNVersion);

function getScreenNVersion(e:MouseEvent):void{
    screenInfoTxt.text= "flash.system.Capabilities.screenResolutionX is : " + String(flash.system.Capabilities.screenResolutionX) + "\n" +
    "flash.system.Capabilities.screenResolutionY is : " + String(flash.system.Capabilities.screenResolutionY) + "\n" +
    "flash.system.Capabilities.version is : " + flash.system.Capabilities.version;
}

Sistemin belirli türdeki bir çok kanallı sesi destekleyip desteklemediğini belirtir. flash.media.AudioDecoder sınıfı, olası türleri numaralandırır.

AIR profili desteği: Çok kanallı ses yalnızca AIR for TV aygıtlarında desteklenir. Diğer aygıtlarda bu yöntem her zaman false değerini döndürür. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.

Not: DTS ses codec'lerinden biri kullanılırken, hasMultiChannelAudio() öğesinin true döndürdüğü, ancak DTS sesinin çalınmadığı senaryolar mevcuttur. Örneğin, eski bir amfiye bağlı, S/PDIF çıkışına sahip bir Blu-ray oynatıcısı olduğunu düşünelim. Eski amfi DTS'yi desteklemez, ancak S/PDIF'in Blu-ray oynatıcısına durumu bildirecek herhangi bir protokolü yoktur. Blu-ray oynatıcısı eski amfiye DTS akışını gönderirse, kullanıcı herhangi bir ses duymaz. Bu nedenle, DTS kullanırken en iyi uygulama olarak, sesin çalınmaması durumunda kullanıcının bunu fark edebilmesi için bir kullanıcı arabirimi sağlayın. Böylece, uygulamanız farklı bir codec'e geçebilir.

Aşağıdaki tablo her bir çok kanallı ses türü için sunucu dizesini gösterir:

Parametreler

İlgili API Öğeleri

    trace(Capabilities.hasMultiChannelAudio(flash.media.AudioDecoder.DOLBY_DIGITAL);