System - Adobe ActionScript® 3 (AS3 ) API Başvurusu

Paket	flash.system
Sınıf	public final class System
Miras Alma	System Object

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

System sınıfı yerel ayarlar ve işlemlere ilişkin özellikler içerir. Bunların yanı sıra, kamera ve mikrofonlar için ayarlar, paylaşılan nesnelerle yapılan işlemler ve Panonun kullanımı da vardır.

Ek özellikler ve yöntemler, flash.system paketi içindeki diğer sınıflarda bulunur: Capabilities sınıfı, IME sınıfı ve Security sınıfı.

Bu sınıf yalnızca statik yöntemleri ve özellikleri içerir. System sınıfın yeni örneklerini oluşturamazsınız.

Örnekleri görüntüle

İlgili API Öğeleri

flash.system.Security
flash.events.IMEEvent

Genel Özellikler

Miras Alınan Genel Özellikleri Gizle

Miras Alınan Genel Özellikleri Göster

	Özellik		Tanımlayan:
		constructor : Object Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru.	Object
		freeMemory : Number [statik] [salt okunur] Adobe® Flash® Player veya Adobe® AIR® uygulamalarına ayrılan ve kullanımda olmayan bellek miktarı (bayt cinsinden).	System
		ime : IME [statik] [salt okunur] Geçerli olarak yüklü sistem IME'si.	System
		privateMemory : Number [statik] [salt okunur] Bir uygulama tarafından kullanılan bellek miktarı (bayt cinsinden).	System
		totalMemory : uint [statik] [salt okunur] Doğrudan Flash Player veya AIR tarafından ayrılan ve o sırada kullanımda olan bellek miktarı (bayt cinsinden).	System
		totalMemoryNumber : Number [statik] [salt okunur] Doğrudan Flash Player veya AIR tarafından ayrılan ve o sırada kullanımda olan bellek miktarı (bayt cinsinden).	System
		useCodePage : Boolean [statik] Harici metin dosyalarını yorumlarken hangi kod sayfasını kullanacağını belirleyen Boolean değeri.	System

Genel Yöntemler

Miras Alınan Genel Yöntemleri Gizle

Miras Alınan Genel Yöntemleri Göster

	Yöntem		Tanımlayan:
		disposeXML(node:XML):void [statik] Belirtilen XML nesnesini anında çöp toplama için kullanılabilir yapar.	System
		exit(code:uint):void [statik] Flash Player'ı kapatır.	System
		gc():void [statik] Çöp toplama işlemini mecbur kılar.	System
		hasOwnProperty(name:String):Boolean Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir.	Object
		isPrototypeOf(theClass:Object):Boolean Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir.	Object
		pause():void [statik] Flash Player veya AIR Hata Ayıklama Başlatıcısı'nı (ADL) durdurur.	System
		pauseForGCIfCollectionImminent(imminence:Number = 0.75):void [statik] Çöp toplayıcıya, toplayıcının yakınlığı işlevin yakınlık parametresini aşarsa artımlı toplama döngüsünü bitirmesi gerektiğini söyleyin.	System
		propertyIsEnumerable(name:String):Boolean Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir.	Object
		resume():void [statik] System.pause() yönteminin çağrılmasından sonra uygulamayı devam ettirir.	System
		setClipboard(string:String):void [statik] Pano'nun içeriğini belirtilen metin dizesi ile değiştirir.	System
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar.	Object
		toLocaleString():String Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür.	Object
		toString():String Belirtilen nesnenin dize olarak temsil edilen halini döndürür.	Object
		valueOf():Object Belirtilen nesnenin temel değerini döndürür.	Object

Özellik Ayrıntısı

freeMemory

özellik

freeMemory:Number [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Adobe^® Flash^® Player veya Adobe^® AIR^® uygulamalarına ayrılan ve kullanımda olmayan bellek miktarı (bayt cinsinden). Ayrılan belleğin kullanılmayan bölümü, (System.totalMemory) çöp toplama gerçekleşirken azalıp çoğalır. Bu özelliği çöp toplamayı izlemek için kullanın.

Uygulama
public static function get freeMemory():Number

İlgili API Öğeleri

privateMemory
totalMemory
totalMemoryNumber

ime

özellik

ime:IME [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Geçerli olarak yüklü sistem IME'si. imeComposition olayları için kaydolmak üzere, bu örnekte addEventListener() öğesini çağırın.

Uygulama
public static function get ime():IME

İlgili API Öğeleri

IMEConversionMode

privateMemory

özellik

privateMemory:Number [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Bir uygulama tarafından kullanılan bellek miktarı (bayt cinsinden). Bu, işlemin tamamı için kalıcı özel bellek miktarıdır.

AIR geliştiricileri bu özelliği bir uygulamanın bellek tüketiminin tamamını belirlemek için kullanmalıdır.

Flash Player için, bu, kap uygulaması tarafından kullanılan belleği içerir, örneğin bir web tarayıcısı.

Uygulama
public static function get privateMemory():Number

İlgili API Öğeleri

freeMemory
totalMemory
totalMemoryNumber

totalMemory

özellik

totalMemory:uint [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Doğrudan Flash Player veya AIR tarafından ayrılan ve o sırada kullanımda olan bellek miktarı (bayt cinsinden).

Bu özellik bir Adobe AIR uygulaması veya Flash Player içeren uygulama (örneğin bir tarayıcı) tarafından kullanılan tüm belleği döndürmez. Tarayıcı veya işletim sistemi başka bir bellek tüketebilir. System.privateMemory özelliği bir uygulama tarafından kullanılan tüm belleği yansıtır.

Ayrılan bellek miktarı bir uint nesnesine ilişkin maksimum değerse (uint.MAX_VALUE, veya 4,294,967,295), bu özellik 0'a ayarlanır. System.totalMemoryNumber özelliği daha yüksek değerlere olanak verir.

Uygulama
public static function get totalMemory():uint

İlgili API Öğeleri

freeMemory
privateMemory
totalMemoryNumber

totalMemoryNumber

özellik

totalMemoryNumber:Number [salt okunur]

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 2

Doğrudan Flash Player veya AIR tarafından ayrılan ve o sırada kullanımda olan bellek miktarı (bayt cinsinden).

Bu özellik System.totalMemory özelliğinden daha yüksek değerlere olanak veren ve int türünden olan bir Sayı olarak ifade edilir.

Uygulama
public static function get totalMemoryNumber():Number

İlgili API Öğeleri

freeMemory
privateMemory
totalMemory

useCodePage

özellik

useCodePage:Boolean

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9, Flash Lite 4

Harici metin dosyalarını yorumlarken hangi kod sayfasını kullanacağını belirleyen Boolean değeri. Özellik false olarak ayarlandığında, harici metin dosyaları Unicode olarak yorumlanır. (Bu dosyalar, siz onları kaydederken Unicode olarak kodlanmalıdır.) Bu özellik true ayarlandığında, harici metin dosyaları, uygulamayı çalıştıran işletim sisteminin geleneksel kod sayfasını kullanılarak yorumlanır. useCodePage öğesinin varsayılan değeri: false.

Harici dosya olarak yüklediğiniz metin (Loader.load(), URLLoader sınıfı veya URLStream kullanarak), uygulamanın metni Unicode olarak tanıması için Unicode olarak kaydedilmelidir. Harici dosyaları Unicode olarak kodlamak için dosyaları Windows'taki Not Defteri gibi Unicode destekleyen bir uygulama içine kaydedin.

Unicode olarak kodlanmamış harici metin dosyalarını yüklerseniz, useCodePage öğesini true olarak ayarlayın. Aşağıdakini veriyi yükleyen dosyanın birinci kod satırı olarak ekleyin (Flash Professional için, onu birinci kareye ekleyin):

System.useCodePage = true;

Bu kod varken uygulama, işletim sisteminin geleneksel kod sayfasını kullanarak harici metni yorumlar. Örneğin, bu genelde bir İngilizce Windows işletim sistemi için CP1252 ve bir Japonca işletim sistemi için Shift-JIS olur.

useCodePage öğesini true olarak ayarlarsanız, Flash Player 6 ve sonraki sürümler, metni Flash Player 5'in kabul ettiği şekilde kabul eder. (Flash Player 5 tüm metnin, oynatıcıyı çalıştıran işletim sisteminin geleneksel kod sayfasında olduğunu kabul etmiştir.)

useCodePage öğesini true olarak ayarlarsanız, uygulamayı çalıştıran işletim sisteminin geleneksel kod sayfasının metninizi göstermek üzere harici metin dosyanızda kullanılan karakterleri içermesi gerektiğini unutmayın. Örneğin, Çince karakterler içeren harici bir metin dosyası yüklerseniz, CP1252 kod sayfası kullanan bir sistemde, bu kod sayfası Çince karakter içermediğinden bu karakterler görünmez.

Tüm platformlardaki kullanıcıların uygulamanızda kullanılan harici metin dosyalarını görebilmelerini sağlamak için tüm harici metin dosyalarını Unicode olarak kodlamanız ve useCodePage özelliğini false olarak ayarlanmış şekilde bırakmanız gerekir. Böylece, uygulama (Flash Player 6 veya daha sonrası, veya AIR) metni Unicode olarak yorumlar.

Uygulama
public static function get useCodePage():Boolean
public static function set useCodePage(value:Boolean):void

İlgili API Öğeleri

flash.display.Loader.load()

Yöntem Ayrıntısı

disposeXML

()

yöntem

public static function disposeXML(node:XML):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 10.1, AIR 1.5.2

Belirtilen XML nesnesini anında çöp toplama için kullanılabilir yapar. Bu yöntem belirtilen XML düğümüne ilişkin tüm düğümler arasındaki üst ve alt bağlantıları kaldırır.

Parametreler

node:XML — Çöp toplama için kullanılabilir hale getirilmesi gereken XML başvurusu.

exit

()

yöntem

public static function exit(code:uint):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9.0.115.0

Flash Player'ı kapatır.

Yalnızca tek başına çalışabilen Flash Player'ın hata ayıklayıcı sürümünde geçerlidir.

AIR uygulamaları, uygulamadan çıkmak için NativeApplication.exit() yöntemini çağırmalıdır.

Parametreler

code:uint — İşletim sistemine iletilecek değer. Genellikle, işlemden normal bir şekilde çıkıldığında, değer 0'dır.

İlgili API Öğeleri

flash.desktop.NativeApplication.exit()

gc

()

yöntem

public static function gc():void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Çöp toplama işlemini mecbur kılar.

Yalnızca Flash Player hata ayıklayıcı sürümü ve AIR uygulamaları için. Bir AIR uygulamasında, System.gc() yöntemi yalnızca AIR Hata Ayıklama Başlatıcı (ADL) veya yüklenmiş bir uygulamada, uygulama güvenlik sanal alanındaki içerikte etkindir.

pause

()

yöntem

public static function pause():void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

Flash Player veya AIR Hata Ayıklama Başlatıcısı'nı (ADL) durdurur. Bu yöntem çağrıldıktan sonra, Socket olaylarının teslimi dışında uygulamadaki hiçbir eylem devam etmez.

Yalnızca Flash Player hata ayıklayıcı sürümü ve AIR Hata Ayıklama Başlatıcısı (ADL) için.

İlgili API Öğeleri

resume()

pauseForGCIfCollectionImminent

()

yöntem

public static function pauseForGCIfCollectionImminent(imminence:Number = 0.75):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

Flash Player 11, AIR 3

Çöp toplayıcıya, toplayıcının yakınlığı işlevin yakınlık parametresini aşarsa artımlı toplama döngüsünü bitirmesi gerektiğini söyleyin.

Flash Çalışma Zamanı çöp toplayıcı algoritması, kullanımdaki belleği işaretlerken artışlı olarak çalışır. Kullanılmamış bellek kısımlarını toplarken uygulama yürütmeyi duraklatır. Artışlı toplama döngüsü bittiğinde gerçekleşen bu duraklatma işlemi, istenenden uzun olabilir ve bazı programlarda gözlemlenebilir veya dinlenebilir. Bu işlev, uygulamanın çalışma zamanına hem işaretlemeyi tamamlamak hem de toplamayı gerçekleştirmek için doğru bir zaman olduğunu önermesine olanak verir. Kullanıcı zamanları fark etmediğinde bunlar için olası duraklatmaların zamanlanması, daha iyi bir kullanıcı deneyimi sağlar. Örneğin, bir oyun içindeki bir seviyenin tamamlanmasının ardından oyun bu işlevi çağırarak oyun sırasında duraklama olması olasılığını azaltabilir.

Yakınlık, toplayıcının, işaretleme yoluyla ne kadar uzak ve dolayısıyla bir toplama duraklatmasını tetiklemeye ne kadar yakın olduğuna karar vermesi olarak tanımlanır. Bu işleve yönelik yakınlık bağımsız değişkeni bir eşiktir: çöp toplayıcısı yalnızca gerçek yakınlık eşik değerini aşıyorsa çağrılır. Aksi takdirde, bu çağrı eylem gerçekleştirmeden anında döndürülür.

Bu işlevi düşük bir yakınlık değeriyle çağırarak uygulama, nispeten büyük miktarda bir işaretlemenin tamamlanması gerektiğini kabul etmeyi istediğini belirtir. Diğer yandan, yüksek bir yakınlık değeri uygulamanın yalnızca işaretleme neredeyse tamamlanmış durumdaysa durdurulması gerektiğini belirtir. Duraklatmalar genel olarak birinci durumda, ikinci duruma göre daha uzundur.

Serbest bırakılan bellek miktarı yakınlık parametresine bağlı değildir. Yalnızca serbest bırakılabilecek nesnelerin sayısına bağlıdır. Yakın zamanda uygulama büyük veri yapıları ya da çok sayıda nesneye yönelik başvuruları bıraktıysa, düşük bir yakınlık parametresi söz konusu nesneleri hemen serbest bırakacak bir koleksiyon tetikleyecektir.

Parametreler

imminence:Number (default = 0.75) — 0'ın daha az yakın ve 1'in en yakın anlamına geldiği durumda 0 ile 1 arasında bir sayı. 0'dan düşük değerler varsayılan olarak 0.25 değerini alır. 1.0'dan büyük değerler varsayılan olarak 1.0 değerini alır. NaN varsayılan olarak 0.75 değerini alır.

resume

()

yöntem

public static function resume():void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9.0.115.0, Flash Lite 4

System.pause() yönteminin çağrılmasından sonra uygulamayı devam ettirir.

Yalnızca Flash Player hata ayıklayıcı sürümü ve AIR Hata Ayıklama Başlatıcısı (ADL) için.

İlgili API Öğeleri

pause()

setClipboard

()

yöntem

public static function setClipboard(string:String):void

Dil Sürümü:

ActionScript 3.0

Çalışma Zamanı Sürümleri:

AIR 1.0, Flash Player 9

Pano'nun içeriklerini belirtilen metin dizesi ile değiştirir. Bu yöntem bir kullanıcı olayı sonucunda çağrıldığında herhangi bir güvenlik bağlamında (bir klavye veya giriş aygıtı olay işleyicisi) çalışır.

Bu yöntem, Flash Player'da çalışan SWF içeriği için sağlanır. Yalnızca String içeriğinin Pano'ya eklenmesini sağlar.

Flash Player 10 içeriği ve bir AIR uygulamasında uygulama güvenlik sanal alanında bulunan içerik, Clipboard.setData() yöntemini çağırabilir.

Parametreler

string:String — Sistem Pano'suna geçerli içeriğiyle (varsa) değiştirilip yerleştirilecek olan karakter düz metin dizesi.

İlgili API Öğeleri

flash.desktop.Clipboard

Örnekler Bu örnek nasıl kullanılır?

SystemExample.as

Şu örnek, System.setClipboard() yöntemine yapılan çağrı içindeki System.totalMemory çağrısını kullanarak sistem Pano'suna sisteminizin toplam belleği hakkında nasıl bilgi kopyalayabileceğinizi gösterir.

package {
    import flash.display.Sprite;
    import flash.system.System;

    public class SystemExample extends Sprite {
        public function SystemExample() {
            System.setClipboard("System.totalMemory: " + System.totalMemory);
        }
    }
}

Yasal Uyarılar | Çevrimiçi Gizlilik İlkesi

System - AS3

Paketlerx

Dil Öğeleri

Ekler

Paket flash.system

freeMemory

ime

privateMemory

totalMemory

totalMemoryNumber

useCodePage

disposeXML

exit

gc

pause

pauseForGCIfCollectionImminent

resume

setClipboard