SharedObject  - AS3

Üzerinde geri çağırma yöntemlerinin çağrıldığı nesneyi gösterir. Varsayılan nesne this şeklindedir. client özelliğini başka bir nesneye ayarlayabilirsiniz. Bu durumda geri çağırma yöntemleri o nesne üzerinde çağrılır.

Nesnenin data özelliğine atanan nitelikler koleksiyonu; bu nitelikler paylaşılabilir ve saklanabilir. Her nitelik herhangi bir ActionScript veya JavaScript türünün Array, Number, Boolean, ByteArray, XML, vb. nesnesi olabilir. Örneğin, şu satırlar bir paylaşılan nesnenin çeşitli özelliklerine değerler atar:

     var items_array:Array = new Array(101, 346, 483);
     var currentUserIsAdmin:Boolean = true;
     var currentUserName:String = "Ramona";
     
     var my_so:SharedObject = SharedObject.getLocal("superfoo");
     my_so.data.itemNumbers = items_array;
     my_so.data.adminPrivileges = currentUserIsAdmin;
     my_so.data.userName = currentUserName;
     
     for (var prop in my_so.data) {
       trace(prop+": "+my_so.data[prop]);
     }
     

Nesne kalıcıysa paylaşılan nesnenin data özelliğinin tüm özellikleri kaydedilir ve paylaşılan nesne şu bilgileri içerir:

     userName: Ramona
     adminPrivileges: true
     itemNumbers: 101,346,483
     

Not:so.data = someValue örneğinde olduğu gibi paylaşılan bir nesnenin data özelliğine doğrudan değerler atamayın; Flash Player bu atamaları yok sayar.

Paylaşılan yerel nesnelere yönelik nitelikleri silmek için delete so.data.attributeName şeklinde bir kod kullanın; bir niteliğin paylaşılan yerel bir nesne için null veya undefined olarak ayarlanması niteliği silmez.

Paylaşılan bir nesneye yönelik private değerler oluşturmak amacıyla (nesne kullanımdayken yalnızca istemci örneği tarafından kullanılabilen ve nesne kapalıyken nesneyle birlikte saklanmayan değerler) saklamak için şu örnekteki gibi adı data olmayan özellikler oluşturun:

     var my_so:SharedObject = SharedObject.getLocal("superfoo");
     my_so.favoriteColor = "blue";
     my_so.favoriteNightClub = "The Bluenote Tavern";
     my_so.favoriteSong = "My World is Blue";
     
     for (var prop in my_so) {
       trace(prop+": "+my_so[prop]);
     }
     

Paylaşılan nesne şu verileri içerir:

     favoriteSong: My World is Blue
     favoriteNightClub: The Bluenote Tavern
     favoriteColor: blue
     data: [object Object]
     

Bir sunucuyla kullanılan paylaşılan uzak nesneler için, data özelliğinin tüm nitelikleri paylaşılan nesneye bağlı olan tüm istemciler tarafından kullanılabilir ve nesne kalıcıysa tüm nitelikler kaydedilir. Bir istemci bir niteliğin değerini değiştirirse tüm istemciler artık yeni değeri görebilir.

İlgili API Öğeleri

SWF dosyasında oluşturulan tüm yerel paylaşılan nesneler için varsayılan nesne kodlaması (AMF sürümü). Paylaşılan yerel nesneler bir diske yazıldığında, SharedObject.defaultObjectEncoding özelliği hangi Action Message Format sürümünün kullanılması gerektiğini gösterir: ActionScript 3.0 biçimi (AMF3) veya ActionScript 1.0 veya 2.0 biçimi (AMF0).

Nesne kodlama hakkında, paylaşılan yerel ve uzak nesnelerde kodlama arasındaki farkı da dahil olmak üzere daha fazla bilgi için objectEncoding özelliğine bakın.

SharedObject.defaultObjectEncoding öğesinin varsayılan değeri, ActionScript 3.0 biçimini (AMF3) kullanacak şekilde ayarlanmıştır. ActionScript 2.0 veya 1.0 SWF dosyalarının okuyabildiği paylaşılan yerel nesneleri yazmanız gerekiyorsa, herhangi bir paylaşılan yerel nesne oluşturmadan önce komut dosyanızın başında SharedObject.defaultObjectEncoding öğesini ActionScript 1.0 veya ActionScript 2.0 biçimini (flash.net.ObjectEncoding.AMF0) kullanacak şekilde ayarlayın. Buradan sonra oluşturulan tüm paylaşılan yerel nesneler, AMF0 kodlamasını kullanır ve daha eski içerikle etkileşime geçebilir. Varolan yerel nesnelerin objectEncoding değerini, yerel nesneler oluşturulduktan sonra SharedObject.defaultObjectEncoding öğesini ayarlayarak değiştiremezsiniz.

Nesne kodlamasını, SWF dosyası tarafından oluşturulan tüm paylaşılan nesneler için aynı anda değil de her nesne için ayrı ayrı ayarlamak için yerel paylaşılan nesnenin objectEncoding özelliğini ayarlayın.

İlgili API Öğeleri

İstemcinin paylaşılan nesneye yaptığı değişikliklerin sunucuya saniyede kaç defa gönderildiğini belirtir.

İstemci ve sunucu arasındaki trafik miktarını kontrol etmek istediğinizde bu yöntemi kullanın. Örneğin, istemci ve sunucu arasındaki bağlantı nispeten yavaşsa, fps öğesini nispeten düşük bir değere ayarlamak isteyebilirsiniz. Diğer taraftan istemci, zamanlamanın önemli olduğu çok kullanıcılı bir uygulamaya bağlıysa fps öğesini nispeten yüksek bir değere ayarlamak istemeyebilirsiniz.

fps öğesinin ayarlanması bir sync olayını tetikler ve sunucuda yapılan tüm değişiklikleri günceller. Yalnızca sunucuyu elle konfigüre etmek istiyorsanız fps öğesini 0 olarak ayarlayın.

sync olayı gönderilene kadar değişiklikler sunucuya gönderilmez. Yani, sunucudan gelen yanıtlama zamanı yavaşsa güncellemeler sunucuya bu özellikte belirtilen değerden daha az sıklıkla gönderilebilir.

Bu paylaşılan nesne için nesne kodlaması (AMF sürümü). Paylaşılan bir yerel nesne bir diske yazıldığında, objectEncoding özelliği hangi Action Message Format sürümünün kullanılması gerektiğini gösterir: ActionScript 3.0 biçimi (AMF3) veya ActionScript 1.0 veya 2.0 biçimi (AMF0).

Nesne kodlaması, paylaşılan nesnenin yerel veya uzak olmasına bağlı olarak farklı şekillerde işlenir.

• Paylaşılan yerel nesneler. Paylaşılan yerel nesnelere yönelik objectEncoding özelliğini alabilir veya ayarlayabilirsiniz. objectEncoding değeri bu paylaşılan yerel nesneyi yazmak için hangi biçimlendirmenin kullanıldığını etkiler. Bu paylaşılan yerel nesnenin ActionScript 2.0 veya 1.0 SWF dosyaları tarafından okunabilir olması gerekiyorsa, objectEncoding öğesini ObjectEncoding.AMF0 olarak ayarlayın. Nesne kodlaması AMF3'ü yazacak şekilde ayarlanmış olsa da, Flash Player hala AMF0 paylaşılan yerel nesnelerini okuyabilir. Yani, bu özelliğin varsayılan değerini (ObjectEncoding.AMF3) kullanırsanız, SWF dosyanız hala ActionScript 2.0 veya 1.0 SWF dosyaları tarafından oluşturulmuş paylaşılan nesneleri okuyabilir.
• Paylaşılan uzak nesneler. Sunucuya bağlandığında, paylaşılan uzak bir nesne objectEncoding ayarını ilgili NetConnection örneğinden (paylaşılan uzak nesneye bağlanmak için kullanılan örnek) miras alır. Sunucuya bağlı değilken, paylaşılan uzak bir nesne defaultObjectEncoding ayarını ilgili NetConnection örneğinden miras alır. Paylaşılan uzak nesnenin objectEncoding özelliğinin değeri NetConnection örneği tarafından belirlendiğinden, bu özellik paylaşılan uzak nesneler için salt okunurdur.

İlgili API Öğeleri

Yerel olarak paylaşılan nesnelerin iOS bulut yedekleme hizmetinde yedeklenip yedeklenmeyeceğini belirtir.

true veya false şeklinde belirtin:

• true - Yerel olarak paylaşılan tüm nesnelerin iOS yedekleme bulut hizmetinde yedeklenmesini önler.
• false (varsayılan) - Yerel olarak paylaşılan nesneler, iOS yedekleme bulut hizmetinde yedeklenir.

Bu özellik, yalnızca yerel olarak paylaşılan nesneler için geçerlidir ve yalnızca iOS içindir.

Paylaşılan nesnenin bayt olarak geçerli boyutu.

Flash, tüm data özelliklerine gözatarak paylaşılan nesnenin boyutunu hesaplar; nesnenin data özellikleri ne kadar fazlaysa boyutunu hesaplamak da o kadar zaman alır. Nesne boyutunun tahmin edilmesi önemli miktarda işleme süresi gerektirebilir. Bu nedenle, belirli bir ihtiyacınız olmadığı sürece bu yöntemi kullanmamak isteyebilirsiniz.

import flash.net.SharedObject;

// if these get copied or not
var mySo:SharedObject = SharedObject.getLocal("thehobbit");
mySo.data.username = "bilbobaggins";
trace(mySo.size); // 55

Paylaşılan yerel nesneler için, tüm verileri temizler ve paylaşılan nesneyi diskten siler. Paylaşılan nesneye yapılan başvuru hala etkindir ancak data özellikleri silinir.

Flash Media Server ile kullanılan paylaşılan uzak nesnelerde, clear() öğesi nesnenin bağlantısını keser ve tüm verileri temizler. Paylaşılan nesne yerel olarak kalıcıysa, bu yöntem ayrıca paylaşılan nesneyi diskten siler. Paylaşılan nesneye yapılan başvuru hala etkindir ancak data özellikleri silinir.

package {
    import flash.net.SharedObject;

    public class SharedObject_clear {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_clear() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            if(mySo.data.username == null) {
                mySo.data.username = username;
                trace("set: " + mySo.data.username); // yourUsername
            }
            else {
                mySo.clear();
                trace("cleared: " + mySo.data.username); // undefined
            }
        }
    }
}

Paylaşılan bir uzak nesne ile sunucu arasındaki bağlantıyı kapatır. Paylaşılan bir uzak nesne yerel olarak kalıcıysa, bu yöntem çağrıldıktan sonra kullanıcı, nesnenin yerel kopyası üzerinde değişiklikler yapabilir. Yerel nesne üzerinde yapılan tüm değişikler, kullanıcının paylaşılan uzak nesneye bir sonraki bağlanışında sunucuya gönderilir.

Belirtilen bir NetConnection nesnesi üzerinden bir sunucu üzerindeki paylaşılan uzak bir nesneye bağlanır. getRemote() öğesini çağırdıktan sonra bu yöntemi kullanın. Bağlantı başarılı olduğunda syncolayı gönderilir.

Uzak bir paylaşılan nesneyle birlikte çalışmayı denemeden önce ilk olarak try..catch..finally ifadesini kullanarak herhangi bir hata olup olmadığını kontrol edin. Ardından, paylaşılan nesne üzerinde herhangi bir değişiklik yapmadan önce sync olayını dinleyin ve işleyin. sync olayı gönderilmeden yapılan tüm değişiklikler kaybedilebilir.

Örneğin paylaşılan uzak bir nesneye bağlanmak için connect() yöntemini çağırın.

     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", myNC.uri, false);
     myRemoteSO.connect(myNC);
     

Parametreler

İlgili API Öğeleri

Yerel bir dosyaya hemen yerel olarak kalıcı, paylaşılan bir nesne yazar. Bu yöntemi kullanmıyorsanız, paylaşılan nesne oturumu sona erdiğinde yani, SWF dosyası kapatıldığında, kendisine bir başvuru olmadığı için paylaşılan nesne çöpe toplama işlemine tabi tutulduğunda veya SharedObject.clear() veya SharedObject.close() yöntemini çağırdığınızda Flash Player, paylaşılan nesneyi bir dosyaya yazar.

Bu yöntem SharedObjectFlushStatus.PENDING öğesini döndürürse, Flash Player, kullanıcıdan bu etki alanından gelen nesnelere yönelik disk alanı miktarını artırmasını isteyen bir iletişim kutusu görüntüler. Daha sonra kaydedildiğinde paylaşılan nesneye yönelik alanın artmasını sağlamak için (PENDING dönüş değerlerini önler) minDiskSpace için bir değer iletin. Flash Player dosyayı yazmaya çalıştığında, paylaşılan nesneyi geçerli boyutunda kaydetmek için yeterli alan aramak yerine minDiskSpace öğesine iletilen bayt sayısını arar.

Örneğin, paylaşılan bir nesnenin maksimum boyutunun 500 bayt olmasını bekliyorsanız, başlangıç boyutu daha küçük olsa da minDiskSpace için 500 değerini iletin. Flash kullanıcıdan paylaşılan nesne için disk alanı ayırmasını isterse bu miktar 500 bayt olur. Kullanıcı istenen alan miktarını ayırdıktan sonra, daha sonra yapılacak olan nesne boşaltma denemelerinde Flash'ın daha fazla disk alanı istemesine gerek kalmaz (boyutu 500 baytı aşmadığı sürece).

Kullanıcı, iletişim kutusuna yanıt verdikten sonra bu yöntem yeniden çağrılır. SharedObject.Flush.Success veya SharedObject.Flush.Failed code özelliğiyle birlikte bir netStatus olayı gönderilir.

Parametreler

İlgili API Öğeleri

package {
    import flash.net.SharedObject;

    public class SharedObject_flush {
        private var hostName:String = "yourDomain";
        private var username:String = "yourUsername";

        public function SharedObject_flush() {
            var mySo:SharedObject = SharedObject.getLocal(hostName);
            mySo.data.username = username;
            var flushResult:Object = mySo.flush();
            trace("flushResult: " + flushResult);
            trace(mySo.data.username); // yourUsername
        }
    }
}

Sadece geçerli istemcinin kullanabildiği yerel olarak kalıcı paylaşılan bir nesneye başvuru döndürür. Paylaşılan nesne önceden mevcut değilse bu yöntem bir tane oluşturur. getLocal() öğesine iletilen herhangi bir değer geçersizse veya çağrı başarısız olursa, Flash Player bir istisna atar.

Şu kod, döndürülmüş paylaşılan nesne başvurusunu bir değişkene nasıl atayacağınızı gösterir:

var so:SharedObject = SharedObject.getLocal("savedData");

Not: Kullanıcı bu etki alanının hiçbir zaman yerel olarak saklanmasına izin verilmemesini seçtiyse, localPath için bir değer belirtilse de nesne yerel olarak kaydedilmez. Bu kurala yönelik istisna yerel içeriktir. Üçüncü taraf paylaşılan nesnelerin diske yazılmasına izin verilmese de yerel içerik her zaman üçüncü taraf etki alanlarından (geçerli tarayıcı adres çubuğundaki etki alanının dışındaki etki alanları) gelen paylaşılan nesneleri yazabilir.

Ad çakışmalarını önlemek için Flash, paylaşılan nesneyi oluşturan SWF dosyasının konumuna bakar. Örneğin www.myCompany.com/apps/stockwatcher.swf konumundaki bir SWF dosyası portfolio adlı bir paylaşılan nesne oluşturursa, SWF dosyaları farklı dizinlerden geldiği için bu paylaşılan nesne, www.yourCompany.com/photoshoot.swf konumundaki portfolio adlı başka bir nesneyle çakışmaz.

localPath parametresi isteğe bağlı olsa da, özellikle başka SWF dosyalarının paylaşılan nesneye erişmesi gerekiyorsa kullanımı konusunda dikkatli olmalısınız. Paylaşılan nesnenin içindeki veriler, başka bir konuma taşınmayacak bir SWF dosyasına özgüyse, varsayılan değerin kullanılması mantıklıdır. Diğer SWF dosyalarının paylaşılan nesneye erişmesi gerekiyorsa veya paylaşılan nesneyi oluşturan SWF dosyası daha sonra taşınacaksa, bu parametrenin değeri, paylaşılan nesneye nasıl erişileceğini etkiler. Örneğin, localPath öğesi, SWF dosyasına giden tam yolun varsayılan değerine ayarlanmış durumdayken bir paylaşılan nesne oluşturursanız, başka bir SWF dosyası bu paylaşılan nesneye erişemez. Orijinal SWF dosyasını daha sonra başka bir konuma taşırsanız, SWF dosyası bile paylaşılan nesnede saklanan verilere erişemez.

Farkında olmadan paylaşılan bir nesneye olan erişimin kısıtlanmasını önlemek için localpath parametresini kullanın. En iyi şekilde izin veren yaklaşım localPath öğesini / (eğik çizgi) olarak ayarlamaktır. Böylece paylaşılan nesne, etki alanındaki tüm SWF dosyaları tarafından kullanılabilir ancak, etki alanındaki diğer paylaşılan nesnelerle ad çakışması ihtimali artar. Daha kısıtlayıcı bir yaklaşım localPath öğesini, SWF dosyasına giden tam yolun içinde bulunan klasör adlarına eklemektir. Örneğin www.myCompany.com/apps/stockwatcher.swf, konumunda SWF dosyası tarafından oluşturulmuş bir portfolio paylaşılan nesnesi için localPath parametresini /, /apps veya /apps/stockwatcher.swf olarak ayarlayabilirsiniz. Hangi yaklaşımın uygulamanız için en iyi düzeyde esneklik sağladığını belirlemelisiniz.

Bu yöntemi kullanırken, aşağıdaki güvenlik modelini göz önünde bulundurun:

• Sanal alan sınırları arasındaki paylaşılan nesnelere erişemezsiniz.
• Kullanıcılar Flash Player Settings (Flash Player Ayarları) iletişim kutusunu veya Settings Manager'ı (Ayarlar Yöneticisi) kullanarak paylaşılan nesne erişimini kısıtlayabilir. Varsayılan olarak, etki alanı başına 100 KB'a kadar veriden oluşan paylaşılan nesneler oluşturabilir. Yöneticiler ve kullanıcılar ayrıca dosya sistemine yazma konusunda kısıtlamalar getirebilir.

Yerel dosyalar olarak oynatılacak (yerel olarak yüklenmiş SWF dosyaları veya EXE dosyaları) SWF dosyası içeriği yayınlayacağınızı düşünün. Bunun için birden fazla yerel SWF dosyasından belirli bir paylaşılan nesneye erişmeniz gerekir. Bu durumda, yerel dosyalarda, paylaşılan nesneleri saklamak için iki farklı konumun kullanılabileceğini unutmayın. Kullanılan etki alanı, paylaşılan nesneyi oluşturan yerel dosyaya verilen güvenlik izinlerine bağlıdır. Yerel dosyalarda üç farklı düzeyde izin vardır:

1. Yalnızca yerel dosya sistemine erişim.
2. Yalnızca ağa erişim.
3. Ağa ve yerel dosya sistemine erişim.

Yerel dosya sistemine erişime sahip (düzey 1 veya 3) yerel dosyalar, paylaşılan nesnelerini bir konumda saklar. Yerel dosya sistemine erişime sahip olmayan (düzey 2) yerel dosyalar, paylaşılan nesnelerini başka bir konumda saklar.

SWF içeriğini barındıran HTML sayfasındaki object veembed etiketlerinin allowNetworking parametresini ayarlayarak bir SWF dosyasının bu yöntemi kullanmasını önleyebilirsiniz.

Daha fazla bilgi için, bkz. Flash Player Geliştirici Merkezi Konusu: Güvenlik.

Parametreler

  ~ % & \ ; : " ' , < > ? # 
  

Flash Media Server üzerinde bulunan ve birden fazla istemcinin erişebildiği paylaşılan bir nesneye bir başvuru döndürür. Paylaşılan uzak nesne önceden mevcut değilse bu yöntem bir tane oluşturur.

Paylaşılan bir uzak nesne oluşturmak için, getRemote() öğesini ve ardından paylaşılan uzak nesneyi şu şekilde sunucuya yüklemek için connect() öğesini çağırın:

     var nc:NetConnection = new NetConnection();
     nc.connect("rtmp://somedomain.com/applicationName");
     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", nc.uri, false);
     myRemoteSO.connect(nc);
     

Paylaşılan nesnenin yerel ve uzak kopyalarının senkronize olduğunu doğrulamak için sync olayını dinleyin ve işleyin. Bu nesneyi paylaşmak isteyen tüm istemciler name ve remotePath parametreleri için aynı değerleri iletmelidir.

Yalnızca geçerli istemci tarafından kullanılabilen bir paylaşılan nesne oluşturmak için SharedObject.getLocal() öğesini kullanın.

Parametreler

    ~ % & \ ; :  " ' , > ? ? #

İlgili API Öğeleri

Belirtilmiş paylaşılan uzak nesneye bağlı tüm istemcilere, mesajı gönderen istemci de dahil olmak üzere bir mesaj yayımlar. Mesajı işlemek veya yanıtlamak için paylaşılan nesneye ekli bir geri çağırma işlevi oluşturun.

Parametreler

Sunucuya, paylaşılan nesnedeki (data özelliği ile tanımlanan) bir özelliğinin değerinin değiştiğini gösterir. Bu yöntem, özellikleri değiştirilmiş anlamına gelen dirty şeklinde işaretler.

Paylaşılan bir nesneye yönelik özellikler oluşturmak için SharedObject.setProperty() öğesini çağırın.

SharedObject.setProperty() yöntemi setDirty() öğesini uygular. Bir özelliğin değerinin String veya Number gibi temel bir tür olması gibi birçok durumda, setDirty() öğesini çağırmak yerine setProperty() öğesini çağırabilirsiniz. Ancak bir nesnenin değeri, kendi özelliklerini içeren bir nesneyse nesne içerisindeki bir değerin değiştiğini göstermek için setDirty() öğesini çağırın.

Parametreler

İlgili API Öğeleri

Paylaşılan bir nesnedeki özelliğin değerini günceller ve sunucuya özelliğin değerinin değiştiğini gösterir. setProperty() yöntemi özellikleri açık bir biçimde changed veya dirty olarak işaretler.

Paylaşılan uzak nesneler hakkında daha fazla bilgi için Flash Media Server belgelerine bakın.

Not: SharedObject.setProperty() yöntemi, setDirty() yöntemini uygular. Bir özelliğin değerinin String veya Number gibi temel bir tür olması gibi birçok durumda, setDirty öğesini çağırmak yerine setProperty() öğesini kullanın. Ancak, bir nesnenin değeri, kendi özelliklerini içeren bir nesneyse nesne içerisindeki bir değerin değiştiğini göstermek için setDirty() öğesini kullanın. setProperty() bir özellik değerini yalnızca değer değiştiğinde güncellerken setDirty() tüm abone istemciler üzerinde senkronizasyonu zorladığından, genellikle setDirty() yerine setProperty() öğesini çağırmanız işe yarayabilir.

Parametreler

İlgili API Öğeleri

Eşzamansız olarak, yani yerel eşzamansız koddan bir istisna atıldığında gönderilir.

Bu olay şu özelliklere sahiptir:

Bir SharedObject örneği durumunu veya hata koşulunu bildirdiğinde gönderilir. netStatus olayı bir info özelliği içerir. Bu özellik, bir bağlantı denemesinin başarılı olup olmadığı veya paylaşılan nesnenin yerel diske başarılı bir şekilde yazılıp yazılmadığı gibi olay hakkında belirli bilgiler içeren bir bilgi nesnesidir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri

Uzaktan paylaşılan bir nesne sunucu tarafından güncellendiğinde gönderilir.

Bu olay şu özelliklere sahiptir:

İlgili API Öğeleri