콜백 Methods가 불려 가는 object를 나타냅니다. 디폴트의 object는 this 입니다. Client property를 다른 object로 설정해, 콜백 Methods를 그 다른 object로 호출할 수가 있습니다.

object의 data property에 할당할 수 있었던 속성의 콜렉션입니다. 이러한 속성은 공유 및 보존할 수가 있습니다. 각각의 속성은, ActionScript 또는 JavaScript 타입의 object입니다. 예를 들어, Array, Number, Boolean, ByteArray, XML 등입니다. 다음의 코드에서는, 공유 object에 다양한 값을 할당하고 있습니다.

  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]);
  }
  

영속적인 object의 경우는, 공유 object의 data property의 모든 속성이 보존됩니다. 또 공유 object에는 다음의 정보가 포함되어 있습니다.

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

메모:so.data = someValue 와 같이, 공유 object의 data property에 값을 직접 할당하지 말아 주세요. 이러한 할당은 무시됩니다.

로컬 공유 object의 속성을 삭제하려면 ,delete so.data.attributeName 라고 하는 코드를 사용합니다. 로컬 공유 object의 속성을 null 또는 undefined 로 설정해도 속성은 삭제되지 않습니다.

공유 object의프라이빗치 (object의 사용중에 그 클라이언트 인스턴스에서만 이용할 수 있어 닫을 때 object와 함께 보존되지 않는 값)를 작성하려면 ,data 이외의 이름의 property를 작성해, 그 값을 보존합니다. 다음에 예를 나타냅니다.

  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]);
  }
  

공유 object에는 다음의 데이터가 포함됩니다.

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

See also

SWF 파일로 작성된 모든 로컬 공유 object의 디폴트 object의 encode (AMF 버젼)입니다. 로컬 공유 object가 디스크에 기입해지면,SharedObject.defaultObjectEncoding property는, 사용할 필요가 있는 Action Message Format 버젼을 나타냅니다. ActionScript 3.0 포맷 (AMF3) 또는 ActionScript 1.0 또는 2.0 포맷 (AMF0)입니다.

로컬 공유 object와 리모트 공유 object의 encode의 차이를 포함한, object encode의 상세한 것에 대하여는,objectEncoding property의 설명을 참조해 주세요.

SharedObject.defaultObjectEncoding 의 디폴트치는, ActionScript 3.0 포맷, AMF3 를 사용하도록(듯이) 설정됩니다. ActionScript 2.0 또는 1.0 SWF 파일로 읽어들일 수 있는 로컬 공유 object의 기입이 필요한 경우는, 로컬 공유 object를 작성하기 전에, 스크립트의 선두 부분에서 ActionScript 1.0 또는 ActionScript 2.0 포맷 flash.net.ObjectEncoding.AMF0 를 사용하도록(듯이) SharedObject.defaultObjectEncoding 를 설정합니다. 그 이후에 작성되는 모든 로컬 공유 object로, AMF0 인코딩이 사용되어 낡은 컨텐츠와 교환할 수 있게 됩니다. 로컬 공유 object의 작성 후에,SharedObject.defaultObjectEncoding 를 설정해도, 기존의 로컬 공유 object의 objectEncoding 값는 변경할 수 없습니다.

SWF 로 작성한 모든 공유 object에 대해서는 아니고, object 마다 object의 인코딩을 설정하려면 , 로컬 공유 object의 objectEncoding property를 설정합니다.

See also

공유 object에 대한 클라이언트의 변경이 서버에 송신되는 회수 (1 초 쯤)를 지정합니다.

클라이언트와 서버간의 트래픽량을 제한하는 경우에, 이 Methods를 사용합니다. 예를 들어, 클라이언트와 서버간의 접속이 약간 늦은 경우는,fps 를 약간 작은 값으로 설정하면 좋을 것입니다. 반대로, 클라이언트가, 타이밍이 중요한 다중 사용자 어플리케이션에 접속하고 있는 경우는,fps 를 약간 큰 값으로 설정하면 좋을 것입니다.

갱신의 송신시에 수동으로 제어하는 경우, 변경을 서버에 보내는 경우는 fps 를 0 으로 설정합니다. 예를 들어, 유저가 서버에 코우신을 보내는 버튼을 누르도록(듯이) 하는 경우는, 버튼에 myRemoteSharedObject.fps(0) 를 추가합니다.

fps 에 건네주는 값에 관련되지 않고,sync

이 공유 object의 encode (AMF 버젼)입니다. 로컬 공유 object가 디스크에 기입해지면,objectEncoding property는, 사용할 필요가 있는 Action Message Format 버젼을 나타냅니다. ActionScript 3.0 포맷 (AMF3) 또는 ActionScript 1.0 또는 2.0 포맷 (AMF0)입니다.

object encode는, 공유 object가 로컬이나 리모트 등에 의해서, 처리 방법이 다릅니다.

• 로컬 공유 object. 로컬 공유 object의 objectEncoding property의 값을 취득 또는 설정할 수 있습니다. objectEncoding 의 값은, 이 로컬 공유 object의 것기입에 사용되는 포맷에 영향을 줍니다. 이 로컬 공유 object를 ActionScript 2.0 또는 1.0 SWF 파일로 읽어들여 가능하게 할 필요가 있는 경우는,objectEncoding 을ObjectEncoding.AMF0 로 설정합니다. object encode가 AMF3 를 기입하도록(듯이) 설정되어 있어도, Flash Player 로 AMF0 로컬 공유 object를 읽어들일 수가 있습니다. 즉, 이 property ObjectEncoding.AMF3 의 디폴트치를 사용해도, ActionScript 2.0 또는 1.0 SWF 파일로 작성한 공유 object를 SFW 파일로 읽어들일 수가 있습니다.
• 리모트 공유 object. 서버에 접속되고 있을 때는, 리모트 공유 object는, 관련짓고 된 NetConnection 인스턴스 (리모트 공유 object에의 접속에 사용되는 인스턴스)로부터 objectEncoding 설정을 Inheritance합니다. 서버에 접속되어 있지 않을 때는, 리모트 공유 object는, 관련짓고 된 NetConnection 인스턴스로부터 defaultObjectEncoding 설정을 Inheritance합니다.

  리모트 공유 object의 objectEncoding property의 값은 NetConnection 인스턴스에 의해 결정되기 (위해)때문에, 이 property는 리모트 공유 object의 읽기 전용(read-only)이 됩니다.

See also

공유 object의 현재의 크기 (바이트수)입니다.

모든 데이터 property를 순서에 확인하는 것에 의해, 공유 object의 크기가 계산됩니다. object가 가지는 데이터 property가 많을 정도(수록), 크기의 계산에 시간이 걸립니다. object의 크기를 조사하는 처리는, 매우 시간이 걸리는 경우가 있어, 특히 필요가 없는 한, 이 Methods의 사용을 피할 수가 있습니다.

See also

import flash.net.SharedObject;

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

로컬 공유 object의 경우, 모든 데이터를 소거해, 공유 object를 디스크로부터 삭제합니다. 공유 object에의 참조는 액티브한 그대로로, 그 데이터 property가 삭제됩니다.

리모트 공유 object의 경우, 이 Methods는, object를 절단 해, 모든 데이터를 소거합니다. 공유 object가 로컬에 영속화 되고 있는 경우, 이 Methods는 디스크로부터 공유 object도 삭제합니다. 공유 object에의 참조는 액티브한 그대로로, 그 데이터 property가 삭제됩니다.

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
            }
        }
    }
}

리모트 공유 object와 서버와의 사이의 접속을 닫습니다. 리모트 공유 object가 로컬에 영속화 되고 있는 경우, 유저는 이 Methods의 호출 후에, object의 로컬 복사를 변경할 수 있습니다. 로컬 object의 변경은, 다음번에 유저가 리모트 공유 object에 접속했을 때에, 서버에 보내집니다.

지정된 접속을 개입시켜, 서버상의 리모트 공유 object에 접속합니다. 이 Methods는 SharedObject.getRemote() 의 발행 후에 사용합니다. 접속이 성공하면,sync 이벤트가 dispatch됩니다.

리모트 공유 object를 사용하기 전에, 우선 접속의 성공을 나타내는 true 의 반환값을 체크해,sync 이벤트가 dispatch될 때까지 대기합니다. 이것을 실시하지 않으면sync 이벤트가 dispatch되기 전에, 로컬로 간 object의 변경이 없어질 가능성이 있습니다.

메모:이 호출이 false 를 돌려주었을 경우,sync 이벤트는 dispatch되지 않습니다.

See also

로컬에 작성된 공유 object를 즉시 로컬 파일에 기입합니다. 이 Methods를 사용하지 않는 경우, 공유 object가 파일에 기입해지는 것은, 그 object의 세션이 종료한 시점됩니다. 즉, 그 SWF 파일이 닫는 시점인가, 그 공유 object에 대한 참조가 없어져 가베지 콜렉션 되는 시점, 또는 SharedObject.clear() 또는 SharedObject.close() 가 불려 간 시점의 머지않아인가입니다.

이 Methods가 SharedObjectFlushStatus.PENDING 를 돌려주었을 경우는, Flash Player 에서는, 이 도메인으로부터의 object를 보존하기 위한 디스크 area를 늘리도록(듯이) 요구하는 다이알로그 박스가 표시됩니다. 장래적으로 공유 object를 보존할 때에, area가 자동적으로 확장되도록(듯이) 하려면 (PENDING 가 돌려주어지지 않게 하기) ,minDiskSpace 에 값을 지정합니다. 파일에 object를 기입하려면 , 현재의 크기의 공유 object를 보존하기 위해서 충분한 area 만이 아니고,minDiskSpace 로 지정한 바이트수가 확인됩니다.

예를 들어, 공유 object가 처음은 작아도 나중에 최대로 500 바이트까지 증가한다고 예상되는 경우에는,minDiskSpace 에 500 을 지정합니다. 유저에 대해서 공유 object에의 디스크 area의 할당을 요구하려면 , 500 바이트의 area가 요구됩니다. 요구된 디스크 area를 유저가 할당했을 경우, 그 이후, object의 크기가 500 바이트를 넘지 않는 이상 object를 보존할 때에 추가의 디스크 area가 요구될 것은 없습니다.

유저가 이 다이알로그 박스에 응답한 후, 이 Methods가 한번 더 불려 가netStatus 이벤트가,SharedObject.Flush.Success 또는 SharedObject.Flush.Failed 의 code property를 사용해 dispatch됩니다.

See also

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
        }
    }
}

현재의 클라이언트만을 이용할 수 있는 로컬 공유 object에의 참조를 돌려줍니다. 공유 object가 아직 존재하지 않는 경우는, 이 Methods에 의해 작성됩니다. getLocal() 에게 건네진 값이 무효인 경우, 또는 호출해에 실패하는 경우는, Flash Player 는 예외를 슬로우 합니다.

다음의 코드에서는, 돌려주어진 공유 object의 참조의 변수에의 할당 방법을 나타냅니다.

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

메모:유저가 이 도메인에 대해서 로컬 기억역을 허가하지 않는 경우는,localPath 가 지정되고 있어도, object는 로컬에 보존되지 않습니다. 다만, 로컬 컨텐츠는 예외입니다. 디스크에의 써드파티의 공유 object의 기입을 허가하고 있지 않는 경우에서도, 로컬 컨텐츠에서는, 항상 써드파티 도메인 (현재의 브라우저의 주소 바에 있는 도메인 이외의 도메인)으로부터의 공유 object를 디스크에 기입할 수가 있습니다.

이름의 충돌을 피하기 위해서(때문에), 공유 object를 작성한 SWF 파일의 위치가 고려됩니다. 예를 들어, www.myCompany.com/apps/stockwatcher.swf 에 있는 SWF 파일이 portfolio 라는 이름의 공유 object를 작성했을 경우, 이 공유 object는, www.yourCompany.com/photoshoot.swf 에 있는 SWF 파일이 작성한 portfolio 라고 하는 다른 object와는 경합 하지 않습니다. 이것은, 이 2 개의 SWF 파일이 다른 디렉토리에 놓여져 있기 때문입니다.

localPath Parameters는 옵션입니다만, 신중하게 사용할 필요가 있습니다. 특히, 다른 SWF 파일이 공유 object에 액세스 해야 하는 경우에는 주의해 주세요. 공유 object의 데이터가, 다른 장소에 이동되지 않는 1 개의 SWF 파일에 고유의 것인 경우는, 디폴트치를 사용하는 것을 추천합니다. 다른 SWF 파일이 공유 object에 액세스 할 필요가 있는 경우, 또는 공유 object를 작성하는 SWF 파일을 다음에 이동하는 경우에는, 이 Parameters의 값에 의해, 공유 object에의 액세스에 영향이 생깁니다. 예를 들어,localPath 를 SWF 파일에의 완전 패스의 디폴트치로 설정해, 공유 object를 작성하면, 다른 SWF 파일은 공유 object에 액세스 할 수 없습니다. 원의 SWF 파일을 다음에 다른 장소로 이동하면, 그 SWF 파일로부터도, 공유 object에 포함되고 있는 데이터에 액세스 할 수 없게 됩니다.

공유 object에의 액세스를 잘못해 제한해 버리는 것을 피하려면 ,localpath Parameters를 사용합니다. 가장 제한의 완만한 방법은,localPath 를 / (slash)로 설정하는 방법입니다. 도메인의 모든 SWF 파일이 공유 object를 이용할 수 있습니다만, 도메인내의 다른 공유 object와의 이름의 충돌이 일어나기 쉬워집니다. 보다 제한의 어려운 방법은,localPath 에 SFW 파일에의 완전 패스내의 폴더명을 부가하는 방법입니다. 예를 들어, www.myCompany.com/apps/stockwatcher.swf 에 있는 SWF 파일로 작성된 portfolio 공유 object의 경우는,localPath Parameters를 /,/apps, 또는 /apps/stockwatcher.swf 로 설정할 수 있습니다. 어플리케이션에 최적인 유연성을 제공할 수 있을 방법이 어떤 것인지를 판단할 필요가 있습니다.

이 Methods를 사용할 때는, Flash Player 시큐러티 모델을 고려해 주세요.

• 샌드 박스의 경계를 넘어 공유 object에 액세스 할 수 없습니다.
• [Flash Player 의 설정] 다이알로그 박스 또는 설정 매니저를 사용해, 공유 object에의 액세스를 제한할 수 있습니다. 디폴트에서는, 어플리케이션으로 도메인 마다 최대 100 KB 의 공유 object를 작성할 수 있습니다. 관리자 및 일반 유저는, 파일 시스템에의 기입해 기능에 제한을 적용할 수도 있습니다.

로컬 파일 (로컬에 설치(Install) 된 SWF 파일 또는 EXE 파일)로서 재생하는 SWF 파일 컨텐츠를 Publish 해, 복수의 로컬 SWF 파일로부터 특정의 공유 object에 액세스 할 필요가 있다고 합니다. 이 상황에서는, 로컬 파일에서는 공유 object의 보존에 2 개가 다른 장소가 사용되는 일이 있을테니 주의해 주세요. 사용되는 도메인은, 공유 object를 작성한 로컬 파일에 부여되는 시큐러티 허가에 의해 바뀝니다. 로컬 파일에는, 다음의 3 개가 다른 허가 레벨을 설정할 수 있습니다.

1. 로컬 파일 시스템에만 대하는 액세스
2. 네트워크에만 대하는 액세스
3. 네트워크와 로컬 파일 시스템의 양쪽 모두에 대한 액세스

로컬 파일 시스템에의 액세스권을 가지는 로컬 파일 (레벨 1 또는 3)은, 공유 object를 1 개의 장소에 포함합니다. 로컬 파일 시스템에의 액세스권을 가지지 않는 로컬 파일 (레벨 2)은, 공유 object를 다른 장소에 포함합니다.

상세한 것에 대하여는, 다음의 주제를 참조해 주세요.

• 「ActionScript 3.0 의 프로그래밍」의시큐러티의 장과 LiveDocs 의 최신 코멘트
• Flash Player 9 시큐러티에 관한 화이트 페이퍼

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

See also

어떠한 서버 (Flash Media Server 등)에 의해 복수 클라이언트에서의 공유를 할 수 있는 object에의 참조를 돌려줍니다. 공유 object가 아직 존재하지 않는 경우는, 이 Methods에 의해 작성됩니다.

다음의 코드에서는, 돌려주어진 공유 object의 참조의 변수에의 할당 방법을 나타냅니다.

var myRemote_so:SharedObject = SharedObject.getRemote(name, remotePath, persistence);

현재의 클라이언트에서만 이용할 수 있는 공유 object를 작성하려면 ,SharedObject.getLocal() 를 사용합니다.

다음의 코드에 나타내도록(듯이), 이 Methods의 호출 후에 SharedObject.connect() 를 사용해, object를 어플리케이션 서버에 접속합니다.

     var myNC:NetConnection = new NetConnection();
     myNC.connect("rtmp://[yourDomain]. com/applicationName");
     var myRemoteSO:SharedObject = SharedObject.getRemote("mo", myNC.uri, false);
     myRemoteSO.connect(myNC);
     

공유 object의 로컬 및 리모트 복사를 동기 시키려면 ,sync 이벤트를 사용합니다.

이 object를 공유하는 모든 클라이언트는,name Parameters와 remotePath Parameters에 같은 값을 건네줄 필요가 있습니다. 리모트 공유 object의 상세한 것에 대하여는, Flash Media Server 의 메뉴얼의 SharedObject.getRemote() 를 참조해 주세요.

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

See also

지정된 리모트 공유 object에 접속하고 있는 모든 클라이언트 (메세지를 송신한 클라이언트도 포함한다)에, 메세지를 브로드캐스트 합니다. 메세지를 처리해 응답하려면 , 공유 object에 송신하는 핸들러 함수를 작성합니다.

공유 object의 property의 값 (data property로 정의)이 변경된 것을 서버에 통지합니다. 이 Methods는, property를 변경이 끝난 상태 (더티)로서 마크 해, 서버 사이드 ActionScript 로 사용합니다.

공유 object의 property를 작성하려면 ,SharedObject.data property를 사용하는지, 단순하게 SharedObject property라고 하는 일의의 이름을 붙인 새로운 property를 작성합니다. 이러한 2 개의 방법의 차이의 상세한 것에 대하여는,SharedObject.data property를 참조해 주세요.

SharedObject.setProperty() Methods에는,setDirty() Methods가 Implements되고 있습니다. 대부분의 경우, 예를 들어 property의 값이 string나 수치등의 원시적형의 경우 등은,setDirty() 는 아니고,setProperty() 를 사용합니다. 다만, property의 값이 독자적인 property를 가지는 object인 경우는,setDirty() 를 사용해 object내의 값이 변경된 일시를 나타냅니다.

See also

공유 object의 property의 값 (data property로 정의)을 갱신해, 서버에 property의 값이 변경된 것을 나타냅니다. setProperty() Methods는, property를 변경이 끝난 상태 (더티)로서 명시적으로 마크 해, 서버 사이드 ActionScript 로 사용합니다. Flash Media Server 등의 서버에는,setProperty() 를 명시적으로 호출해, 공유 object의 property가 변경된 일시를 나타낼 필요가 있는 것도 있습니다.

SharedObject.setProperty() 를 서버 사이드에서 호출했을 경우, 공유 object를 사용하고 있는 모든 Flash Player 클라이언트에 대해서, 클라이언트 사이드에서 sync 이벤트를 통해서 변경 통지가 불려 갑니다. 서버 사이드의 propertyName Parameters는, 클라이언트 사이드의 data property의 속성과 같습니다. 예를 들어, 다음의 코드행은 모두 같습니다. 최초의 2 행은 서버 사이드 ActionScript 로, 3, 4 행 째는 클라이언트 사이드 ActionScript 입니다.

  setProperty("nameVal", "foo");
  setDirty("nameVal");
  data["nameVal"] = "foo";
  data.nameVal = "foo";
  

Flash Media Server 의 유저는, 「 Flash Media Server Server-Side ActionScript Language Reference 」로, 서버 사이드 ActionScript 및 리모트 공유 object에 관한 상세를 참조할 수 있습니다.

메모:SharedObject.setProperty() Methods에는,setDirty() Methods가 Implements되고 있습니다. 대부분의 경우, 예를 들어 property의 값이 string나 수치등의 원시적형의 경우 등은,setDirty 는 아니고,setProperty() 를 사용합니다. 다만, property의 값이 독자적인 property를 가지는 object인 경우는,setDirty() 를 사용해 object내의 값이 변경된 일시를 나타냅니다. 일반적으로,setDirty() 는 아니고 setProperty() 를 호출하는 것을 추천합니다. 이것은,setDirty() 는 예약(subscribe) 하고 있는 모든 클라이언트에 대해서 강제적으로 동기 시킵니다만,setProperty() 는 값이 변경되었을 때만 property치를 갱신하기 (위해)때문에입니다.

See also

비동기 형식에서, 즉 네이티브비동기 코드로부터 예외가 슬로우 되면 dispatch됩니다.

AsyncErrorEvent.ASYNC_ERROR 정수는,asyncError event object의 type property치를 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

SharedObject 인스턴스가, 그 스테이터스 또는 에러의 상황을 리포트할 경우에 dispatch됩니다. netStatus 이벤트에는,info property가 포함됩니다. 이 property는, 접속 시행이 성공했는지 어떠했는지나 공유 object가 로컬 디스크에의 기입에 성공했는지 어떠했는지 등, 이벤트에 관한 특정의 정보를 포함한 정보 object입니다.

netStatus event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also

리모트 공유 object (SharedObject)가 서버에 의해 갱신될 때 dispatch됩니다.

sync event object의 type property의 값을 정의합니다.

이 이벤트에는, 다음의 property가 있습니다.

See also