SharedObject 类

可用性

Flash Player 6。

说明

共享对象相当强大：它们提供用户计算机上永久对象间的实时数据共享。您可以将本地共享对象看作“Cookie”。

您可以使用本地共享对象维持本地永久性。这是使用共享对象最简单的方式。例如，您可以调用 SharedObject.getLocal() 在播放器中创建共享对象，例如具有内存的计算器。因为共享对象在本地是永久性的，所以当 SWF 文件结束时 Flash 会将其数据属性保存在用户的计算机上。SWF 文件下次运行时，计算器仍包含 SWF 文件结束时它所具有的值。或者，如果在 SWF 结束前将共享对象的属性设置为 null，则当 SWF 文件下次运行时，计算器打开时不带有任何以前的值。

若要创建本地共享对象，请使用以下语法：

// 创建本地共享对象
so = SharedObject.getLocal("foo");

本地磁盘空间注意事项

在可用内存和磁盘空间用完之前，客户端上的本地共享对象总是永久性的。

默认情况下，Flash 可以在本地保存多达 100K 大小的永久性远程共享对象。当您尝试保存一个较大的对象时，Flash Player 将显示“本地存储”对话框，用户可以使用该对话框允许或拒绝请求访问的域的本地存储。确保舞台大小至少为 215 x 138 像素；这是 Flash 显示该对话框所需的最小大小。

如果用户单击“允许”，则将保存该对象，并用 SharedObject.Flush.Success 的 code 属性调用 SharedObject.onStatus；如果用户单击“拒绝”，则不保存该对象，并用
SharedObject.Flush.Failed 的 code 属性调用 SharedObject.onStatus。

用户还可以指定特定域的永久本地存储设置，方法是在 SWF 文件播放时右击 (Windows) 或按住 Control 键单击 (Macintosh)，选择“设置”，然后打开“本地存储”面板。

下表总结用户的磁盘空间选择如何与共享对象互相影响：

如果用户选择“从不”，则从不在本地保存对象，为该对象发出的所有
SharedObject.flush() 命令都返回 false。
如果用户选择“无限制”（一直向右移动滑块），则在本地保存对象直到达到最大可用磁盘空间。
如果用户选择“无”（一直向左移动滑块）则为该对象发出的所有 SharedObject.flush()命令都返回 "pending"，播放器将询问用户是否可以分配额外的磁盘空间以容纳该对象，如上所述。
如果用户选择“10 KB”、“100 KB”、“1 MB”或“10 MB”，则将在本地保存对象，并且如果这些对象的大小未超过指定的空间量，则 SharedObject.flush() 返回 true。如果需要更多空间，SharedObject.flush() 将返回 "pending"，播放器将询问用户是否可以分配额外的磁盘空间以容纳该对象，如上所述。

另外，如果用户选择的值小于本地永久数据当前使用的磁盘空间量，则播放器将警告用户将删除所有本地保存的共享对象。

注意：在创作环境中运行的 Flash Player 没有大小限制。

SharedObject 类的方法摘要

方法	说明
`SharedObject.clear()`	清除共享对象中的所有数据并从磁盘删除共享对象。
`SharedObject.flush()`	将本地永久共享对象立即写入本地文件。
`SharedObject.getLocal()`	返回对本地永久共享对象的引用，该对象只可用于当前客户端。
`SharedObject.getSize()`	获取共享对象的当前大小（以字节为单位）。

SharedObject 类的属性摘要

属性（只读）	说明
`SharedObject.data`	分配到该对象 `data` 属性的属性集合，可以共享和/或存储这些属性。

SharedObject 类的事件处理函数摘要

事件处理函数	说明
`SharedObject.onStatus`	每次为共享对象公布错误、警告或信息性通知时调用。

SharedObject 类的构造函数

有关创建本地共享对象的信息，请参见 SharedObject.getLocal()。