Veri olarak yüklenen ortama erişme

Bir BitmapData nesnesinin draw() ve drawWithQuality() (Flash Player 11.3; AIR 3.3) yöntemleri, herhangi bir görüntüleme nesnesinin geçerli olarak görüntülenen piksellerini BitmapData nesnesine çizmenize izin verir. Bunlar arasında, MovieClip nesnesinin, Bitmap nesnesinin veya herhangi bir görüntüleme nesnesinin pikselleri yer alabilir. Bu yöntemlerin BitmapData nesnesine pikselleri çizmesi için şu koşulların karşılanması gerekir:

• Yüklenen bitmap dışında bir kaynak nesne olması durumunda, kaynak nesnenin ve (Sprite veya MovieClip nesnesi olması durumunda) kaynak nesnenin tüm alt nesnelerinin, draw yöntemini çağıran nesneyle aynı etki alanından gelmesi ya da Security.allowDomain() yönteminin çağrılmasıyla çağıran için erişilebilir olan bir SWF dosyasında bulunması gerekir.

• Yüklü bitmap kaynak nesnesi olması durumunda kaynak nesnenin, draw yöntemini çağıran nesneyle aynı etki alanından gelmesi veya kaynak sunucusunun, çağıran etki alana izin veren bir URL ilke dosyası içermesi gerekir.

Bu koşullar karşılanmazsa, SecurityError istisnası atılır.

Loader sınıfının load() yöntemini çağırdığınızda, LoaderContext nesnesi olan bir context parametresini belirtebilirsiniz. LoaderContext nesnesinin checkPolicyFile özelliğini true değerine ayarlarsanız, Flash Player uygulaması, görüntünün yükleneceği sunucuda bir URL ilke dosyasını kontrol eder. İlke dosyası varsa ve dosya, yükleyen SWF dosyasının etki alanına izin veriyorsa, dosyanın Bitmap nesnesindeki verilere erişmesine izin verilir; aksi takdirde erişim reddedilir.

Bir metin alanında <img> etiketi aracılığıyla yüklenmiş bir görüntüde checkPolicyFile özelliğini de belirtebilirsiniz. Ayrıntılar için, bkz. Metin alanında <img> etiketini kullanarak SWF dosyalarını ve görüntüleri yükleme .

Aşağıdaki sesle ilgili ActionScript 3.0 API'leri güvenlik kısıtlamalarına sahiptir:

• SoundMixer.computeSpectrum() yöntemi—Ses dosyasıyla aynı güvenlik sanal alanında çalışan kod için her zaman izin verilir. Diğer sanal alanlardaki kodlar için güvenlik kontrolleri vardır.

• SoundMixer.stopAll() yöntemi—Ses dosyasıyla aynı güvenlik sanal alanında çalışan kod için her zaman izin verilir. Diğer sanal alanlardaki dosyalar için güvenlik kontrolleri vardır.

• Sound sınıfının id3 özelliği—Ses dosyasıyla aynı güvenlik sanal alanında bulunan SWF dosyaları için her zaman izin verilir. Diğer sanal alanlardaki kodlar için güvenlik kontrolleri vardır.

Her ses, kendisiyle ilişkilendirilmiş iki tür sanal alana sahiptir—içerik sanal alanı ve sahip sanal alanı:

• Sesin kaynak etki alanı, içerik sanal alanını belirler ve bu da sesin id3 özelliği ve SoundMixer.computeSpectrum() yöntemi aracılığıyla sesteki verilerin ayıklanıp ayıklanamayacağını belirler.

• Ses çalınmasını başlatan nesne, sahip sanal alanını belirler ve bu da SoundMixer.stopAll() yöntemi kullanılarak sesin durdurulup durdurulamayacağını belirler.

Sound sınıfının load() yöntemini kullanarak ses yüklediğinizde, SoundLoaderContext nesnesi olan bir context parametresini belirtebilirsiniz. SoundLoaderContext nesnesinin checkPolicyFile özelliğini true değerine ayarlarsanız, çalışma zamanı sesin yüklendiği sunucuda URL ilke dosyasını kontrol eder. İlke dosyası varsa ve dosya, yükleyen kodun etki alanına izin veriyorsa, kodun, Sound nesnesinin id özelliğine erişmesine izin verilir; aksi takdirde erişim reddedilir. Ayrıca, checkPolicyFile özelliğinin ayarlanması, yüklenen sesler için SoundMixer.computeSpectrum() yöntemini etkinleştirebilir.

Bir veya birkaç ses sahibinin, sanal alanı çağıran için erişilemez durumda olması nedeniyle SoundMixer.stopAll() yöntemine yapılan bir çağrının tüm sesleri durdurup durdurmayacağını öğrenmek için SoundMixer.areSoundsInaccessible() yöntemini kullanabilirsiniz.

SoundMixer.stopAll() yönteminin çağrılması, sahip sanal alanı, stopAll() yöntemini çağıranın sanal alanıyla aynı olan sesleri durdurur. Bu ayrıca stopAll() yöntemini çağıran SWF dosyasının etki alanına erişim izni vermek için Security.allowDomain() yöntemini çağıran SWF dosyaları tarafından oynatımı başlatılan sesleri de durdurur. Diğer sesler durdurulmaz ve SoundMixer.areSoundsInaccessible() yöntemi çağrılarak bu seslerin varlığı ortaya çıkarılabilir.

computeSpectrum() yönteminin çağrılması için, çalınan her sesin, yöntemi çağıran nesneyle aynı sanal alanda veya çağıranın sanal alanına erişim izni verilmiş bir kaynakta olması gerekir; aksi takdirde SecurityError istisnası atılır. Bir SWF dosyasındaki kütüphanede bulunan gömülü seslerden yüklenmiş sesler için, yüklenen SWF dosyasında Security.allowDomain() yöntemine yapılan bir çağrıyla izin verilir. SWF dosyaları dışındaki kaynaklardan yüklenmiş (yüklenmiş mp3 dosyalarından veya video dosyalarından gelen) sesler için, kaynak sunucudaki bir URL ilke dosyası, yüklenen ortamdaki verilere erişim izni verir.

Daha fazla bilgi için bkz. Yazar (geliştirici) denetimleri ve Web sitesi denetimleri (ilke dosyaları) .

Ses verilerine RTMP akışlarından erişmek için, sunucuya erişime izin vermelisiniz. Flash Media Server’daki belli dizinlere erişime izin vermek için Sunucu-Tarafı ActionScript Client.audioSampleAccess özelliğini kullanın. Daha fazla bilgi için bkz. Sunucu Tarafı ActionScript Dil Başvurusu .

Geçerli video karesinin piksel verilerini yakalamak için BitmapData.draw() veya BitmapData.drawWithQuality() yöntemini kullanabilirsiniz. ( drawWithQuality yöntemi Flash Player 11.3 ve üstü ile AIR 3.3 ve üstünde kullanılabilir.)

İki farklı video türü vardır:

• Flash Media Server’dan RTMP üzerinden akan video

• Bir FLV veya F4V dosyasından yüklenen aşamalı video

RTMP akışlarından çalışma zamanı grafiklerini ayıklamak amacıyla draw yönetmelerini kullanmak için, sunucuya erişim izni vermelisiniz. Flash Media Server’daki belli dizinlere erişime izin vermek için Sunucu-Tarafı ActionScript Client.audioSampleAccess özelliğini kullanın. Daha fazla bilgi için bkz. Sunucu Tarafı ActionScript Dil Başvurusu .

source parametresi olarak aşamalı video ile bir draw yöntemini çağırdığınızda, yöntem çağıranının FLV dosyasıyla aynı korumalı alandan olması veya FLV dosyasının sunucusunun, çağıran SWF dosyasının etki alanına izin veren bir ilke dosyasına sahip olması gerekir. NetStream nesnesinin checkPolicyFile özelliğini true değerine ayarlayarak ilke dosyasının indirilmesini isteyebilirsiniz.