GroupSpecifier

包	flash.net
类	public class GroupSpecifier
继承	GroupSpecifier Object

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

GroupSpecifier 类用于构造可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串。groupspec 指定 RTMFP 对等组，包括使用 groupspec 的成员的能力、限制和授权。

默认情况下，禁用所有功能，但允许对等连接。

相关 API 元素

flash.net.NetGroup
flash.net.NetStream

公共属性

隐藏继承的公共属性

显示继承的公共属性

	属性		由以下参数定义
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		ipMulticastMemberUpdatesEnabled : Boolean 指定是否可以在 IP 多播套接字中交换有关组成员资格的信息。	GroupSpecifier
		maxSupportedGroupspecVersion : int [静态] [只读] 指定此运行时支持的 groupspec 最高版本。	GroupSpecifier
		minGroupspecVersion : int 指定生成的 groupspec 将具有的最低版本号。	GroupSpecifier
		multicastEnabled : Boolean 指定是否为 NetGroup 启用流。	GroupSpecifier
		objectReplicationEnabled : Boolean 指定是否为 NetGroup 启用对象复制。	GroupSpecifier
		peerToPeerDisabled : Boolean 指定是否为 NetGroup 或 NetStream 禁用对等连接。	GroupSpecifier
		postingEnabled : Boolean 指定是否为 NetGroup 启用发布。	GroupSpecifier
		routingEnabled : Boolean 指定是否为 NetGroup 启用定向路由方法。	GroupSpecifier
		serverChannelEnabled : Boolean 指定 NetGroup 的成员是否可以打开到服务器的通道。	GroupSpecifier

公共方法

隐藏继承的公共方法

显示继承的公共方法

	方法		由以下参数定义
		GroupSpecifier(name:String) 创建一个新的 GroupSpecifier 对象。	GroupSpecifier
		addBootstrapPeer(peerID:String):void 导致关联的 NetStream 或 NetGroup 与指定的 peerID 进行初始邻居连接。	GroupSpecifier
		addIPMulticastAddress(address:String, port:* = null, source:String = null):void 导致关联的 NetStream 或 NetGroup 加入指定的 IP 多播组并侦听指定的 UDP 端口。	GroupSpecifier
		authorizations():String 返回表示用于 IP 多播发布和用于发布的密码的字符串。	GroupSpecifier
		encodeBootstrapPeerIDSpec(peerID:String):String [静态] 编码并返回表示启动 peerID 的字符串。	GroupSpecifier
		encodeIPMulticastAddressSpec(address:String, port:* = null, source:String = null):String [静态] 编码并返回表示 IP 多播套接字地址的字符串。	GroupSpecifier
		encodePostingAuthorization(password:String):String [静态] 编码并返回表示发布密码的字符串。	GroupSpecifier
		encodePublishAuthorization(password:String):String [静态] 编码并返回表示多播发布密码的字符串。	GroupSpecifier
		groupspecWithAuthorizations():String 返回可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串，包括授权。	GroupSpecifier
		groupspecWithoutAuthorizations():String 返回可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串，不包括授权。	GroupSpecifier
		hasOwnProperty(name:String):Boolean 表示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 表示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		makeUnique():void 向 groupspec 添加强伪随机标记，使其具有唯一性。	GroupSpecifier
		propertyIsEnumerable(name:String):Boolean 表示指定的属性是否存在、是否可枚举。	Object
		setPostingPassword(password:String = null, salt:String = null):void 指定在 NetGroup 中发布是否要求密码。	GroupSpecifier
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		setPublishPassword(password:String = null, salt:String = null):void 指定在 NetStream 中发布多播流是否要求密码。	GroupSpecifier
		toLocaleString():String 返回此对象的字符串表示形式，其格式设置遵守区域设置特定的约定。	Object
		toString():String 与 groupspecWithAuthorizations() 方法相同。	GroupSpecifier
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

ipMulticastMemberUpdatesEnabled

属性

ipMulticastMemberUpdatesEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否可以在 IP 多播套接字中交换有关组成员资格的信息。IP 多播服务器可以发送组成员资格更新以帮助启动 P2P 网格或修复分区。同级可以发送 LAN 上的组成员资格更新以帮助启动 LAN P2P 网格和通知全局网格中的 on-LAN 邻居其他 on-LAN 邻居存在。这些更新可以提高 P2P 性能。

实现
public function get ipMulticastMemberUpdatesEnabled():Boolean
public function set ipMulticastMemberUpdatesEnabled(value:Boolean):void

maxSupportedGroupspecVersion

属性

maxSupportedGroupspecVersion:int [只读]

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 11.5, AIR 3

指定此运行时支持的 groupspec 最高版本。版本比之高的 groupspec 在此运行时中将失败。

实现
public static function get maxSupportedGroupspecVersion():int

相关 API 元素

minGroupspecVersion

属性

minGroupspecVersion:int

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 11.5, AIR 3

指定生成的 groupspec 将具有的最低版本号。如果启用了需要更高版本号的选项，则 groupspec 版本号可能会比此值高。版本号比所支持的最低版本还要低的 groupspec 将会失败。

实现
public function get minGroupspecVersion():int
public function set minGroupspecVersion(value:int):void

相关 API 元素

maxSupportedGroupspecVersion

multicastEnabled

属性

multicastEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否为 NetGroup 启用流。用于流的方法是 NetStream.publish()、NetStream.play() 和 NetStream.play2()。默认情况下，此属性为 FALSE（禁用流）。

实现
public function get multicastEnabled():Boolean
public function set multicastEnabled(value:Boolean):void

objectReplicationEnabled

属性

objectReplicationEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否为 NetGroup 启用对象复制。默认情况下，此属性为 FALSE（对象复制被禁用）。

实现
public function get objectReplicationEnabled():Boolean
public function set objectReplicationEnabled(value:Boolean):void

peerToPeerDisabled

属性

peerToPeerDisabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否为 NetGroup 或 NetStream 禁用对等连接。默认情况下，此属性为 FALSE（启用 P2P 连接）。

如果禁用 P2P 连接（将此属性设置为 TRUE），则禁止 P2P 警告对话框。在这种情况下，不能进行任何相邻连接，并且任何组成员都不使用上游带宽。通过这种方式禁用 P2P 连接通常仅在通过纯 IP 多播接收多播流时有用。

实现
public function get peerToPeerDisabled():Boolean
public function set peerToPeerDisabled(value:Boolean):void

postingEnabled

属性

postingEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否为 NetGroup 启用发布。默认情况下，此属性为 FALSE（禁用发布）。

实现
public function get postingEnabled():Boolean
public function set postingEnabled(value:Boolean):void

相关 API 元素

flash.net.NetGroup.post()

routingEnabled

属性

routingEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定是否为 NetGroup 启用定向路由方法。默认情况下，此属性为 FALSE（定向路由方法被禁用）。

实现
public function get routingEnabled():Boolean
public function set routingEnabled(value:Boolean):void

相关 API 元素

flash.net.NetGroup.sendToNearest()

serverChannelEnabled

属性

serverChannelEnabled:Boolean

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定 NetGroup 的成员是否可以打开到服务器的通道。默认情况下，此属性为 FALSE。

只有打开服务器通道，服务器才能将支持功能提供给组成员。根据服务器配置，支持功能可能通过此通道提供，也可能不通过此通道提供。

实现
public function get serverChannelEnabled():Boolean
public function set serverChannelEnabled(value:Boolean):void

构造函数详细信息

()

构造函数

public function GroupSpecifier(name:String)

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

创建一个新的 GroupSpecifier 对象。默认情况下，禁用所有功能，但允许对等连接。

参数

name:String — 所有成员必须同意组名称。

引发

ArgumentError — 如果 name 为空或 null。

相关 API 元素

flash.net.NetGroup
flash.net.NetStream

方法详细信息

addBootstrapPeer

()

方法

public function addBootstrapPeer(peerID:String):void

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

导致关联的 NetStream 或 NetGroup 与指定的 peerID 进行初始邻居连接。

参数

peerID:String — 应将初始邻居连接引导入对等网格的 peerID。

addIPMulticastAddress

()

方法

public function addIPMulticastAddress(address:String, port:* = null, source:String = null):void

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

导致关联的 NetStream 或 NetGroup 加入指定的 IP 多播组并侦听指定的 UDP 端口。

参数

	`address:String` — 一个字符串，用于指定要加入的 IPv4 或 IPv6 多播组的地址，可能后跟冒号（“:”）和 UDP 端口号。如果指定 IPv6 地址和端口，则 IPv6 地址必须使用中括号括起来。示例：`“224.0.0.254”`、`“224.0.0.254:30000”`、`“ff03::ffff”`、`“[ff03::ffff]:30000”`。

	`port:*` (default = `null`) — 接收 IP 多播数据报的 UDP 端口。如果 `port` 为 `null`，则必须在 `address` 中指定 UDP 端口。如果不为 `null`，则不得在`address` 中指定 UDP 端口。

	`source:String` (default = `null`) — 如果不为 `null`，则为用于指定特定于源的多播 (SSM) 的源 IP 地址的字符串。

authorizations

()

方法

public function authorizations():String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

返回表示用于 IP 多播发布和用于发布的密码的字符串。将此字符串附加到未授权的 groupspec 以启用已设置密码的功能。

String

encodeBootstrapPeerIDSpec

()

方法

public static function encodeBootstrapPeerIDSpec(peerID:String):String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

编码并返回表示启动 peerID 的字符串。如果将此字符串附加到 groupspec，则关联的 NetStream 或 NetGroup 会进行到指定的 peerID 的初始相邻连接。

参数

peerID:String — 应将初始邻居连接引导入对等网格的 peerID。

String

encodeIPMulticastAddressSpec

()

方法

public static function encodeIPMulticastAddressSpec(address:String, port:* = null, source:String = null):String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

编码并返回表示 IP 多播套接字地址的字符串。如果将此字符串附加到 groupspec，则关联的 NetStream 或 NetGroup 会加入指定的 IP 多播组并侦听指定的 UDP 端口。

参数

	`address:String` — 一个字符串，用于表示要加入的 IPv4 或 IPv6 多播组的地址，可能后跟冒号（“:”）和 UDP 端口号。如果指定 IPv6 地址和端口，则 IPv6 地址必须使用中括号括起来。示例：`“224.0.0.254”`、`“224.0.0.254:30000”`、`“ff03::ffff”`、`“[ff03::ffff]:30000”`。

	`port:*` (default = `null`) — 接收 IP 多播数据报的 UDP 端口。如果 `port` 为 `null`，则必须在 `address` 中指定 UDP 端口。如果不为 `null`，则不得在`address` 中指定 UDP 端口。

	`source:String` (default = `null`) — 如果不为 `null`，则为用于指定特定于源的多播 (SSM) 的源 IP 地址的字符串。

String

encodePostingAuthorization

()

方法

public static function encodePostingAuthorization(password:String):String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

编码并返回表示发布密码的字符串。当发布受密码保护时，可将字符串连接到 groupspec 以启用发布。

参数

password:String — 要编码的密码，此密码必须与发布的密码（如果设置）匹配才能启用 NetGroup.post()。

String

encodePublishAuthorization

()

方法

public static function encodePublishAuthorization(password:String):String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

编码并返回表示多播发布密码的字符串。当多播发布受密码保护时，可将字符串连接到 groupspec 以启用发布。

参数

password:String — 要编码的密码，此密码必须与发布密码（如果设置）匹配才能启用 NetStream.publish()。

String

groupspecWithAuthorizations

()

方法

public function groupspecWithAuthorizations():String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

返回可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串，包括授权。

String

groupspecWithoutAuthorizations

()

方法

public function groupspecWithoutAuthorizations():String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

返回可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串，不包括授权。

String

makeUnique

()

方法

public function makeUnique():void

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

向 groupspec 添加强伪随机标记，使其具有唯一性。不透明的 groupspec 字符串随后必须逐字传递到组的其他潜在成员（如果这些成员已成功加入）。

setPostingPassword

()

方法

public function setPostingPassword(password:String = null, salt:String = null):void

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定在 NetGroup 中发布是否要求密码。

参数

	`password:String` (default = `null`) — 使用 `NetGroup.post()` 所必须提供的密码。如果为 `null`，则表明发布不要求任何密码。

	`salt:String` (default = `null`) — 修改密码的哈希以增加破解难度。为获得最佳安全性，此参数应设置为随机值。

setPublishPassword

()

方法

public function setPublishPassword(password:String = null, salt:String = null):void

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

指定在 NetStream 中发布多播流是否要求密码。

参数

	`password:String` (default = `null`) — 使用 `NetStream.publish()` 所必须提供的密码。如果为 `null`，则发布不要求任何密码。

	`salt:String` (default = `null`) — 修改密码的哈希以增加破解难度。为获得最佳安全性，此参数应设置为随机值。

toString

()

方法

public function toString():String

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10.1, AIR 2

与 groupspecWithAuthorizations() 方法相同。返回可传递给 NetStream 和 NetGroup 构造函数的不透明的 groupspec 字符串（包括授权）的便捷方法。

String

相关 API 元素

groupspecWithAuthorizations()

法律声明 | 在线隐私策略

GroupSpecifier - AS3

类 x

ipMulticastMemberUpdatesEnabled

maxSupportedGroupspecVersion

minGroupspecVersion

multicastEnabled

objectReplicationEnabled

peerToPeerDisabled

postingEnabled

routingEnabled

serverChannelEnabled

GroupSpecifier

addBootstrapPeer

addIPMulticastAddress

authorizations

encodeBootstrapPeerIDSpec

encodeIPMulticastAddressSpec

encodePostingAuthorization

encodePublishAuthorization

groupspecWithAuthorizations

groupspecWithoutAuthorizations

makeUnique

setPostingPassword

setPublishPassword

toString