Flash类似于cookies功能 - SharedObject 类

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()。