Specifies the estimated number of members of the group, based on local neighbor density and assuming an even distribution of group addresses.

See also

Returns a NetGroupInfo object whose properties provide Quality of Service statistics about this NetGroup's RTMFP peer-to-peer data transport.

See also

Specifies the start of the range of group addresses for which this node is the "nearest" and responsible. The range is specified in the increasing direction along the group address ring mod 2²⁵⁶.

See also

Specifies the end of the range of group addresses for which this node is the "nearest" and responsible. The range is specified in the increasing direction along the group address ring mod 2²⁵⁶.

See also

Specifies the number of group members to which this node is directly connected.

See also

Specifies this node's routing receive mode as one of values in the NetGroupReceiveMode enum class.

See also

Specifies the object replication fetch strategy. The value is one of the enumerated values in the NetGroupReplicationStrategy class.

See also

Constructs a NetGroup on the specified NetConnection object and joins it to the group specified by groupspec.

In most cases, a groupspec has the potential for using the network uplink on the local system. When a NetStream or NetGroup object is constructed with a groupspec, Flash Player displays a Privacy Dialog. The dialog asks whether Flash Player can use the connection to share data with a user's peers. If the user clicks "Allow for this domain", the dialog is not displayed the next time the user connects to this application. If a user does not allow peer-assisted networking, all peer features within the group (posting, directed routing, and object replication, and multicast) are disabled. If permission is allowed, a NetStatusEvent is sent to the NetConnection's event listener with NetGroup.Connect.Success in the code property of the info object. If permission is denied, the code property is NetGroup.Connect.Rejected. Until a NetGroup.Connect.Success event is received, an exception is thrown if you try to call any method of the NetGroup object.

Note: When a client subscribes to a native-IP multicast stream, the security dialog is not displayed.

     new NetGroup(myConnection, myGroupSpecifier.groupspecWithAuthorizations());
     

See also

Adds objects from startIndex through endIndex, to the set of objects this node advertises to neighbors as objects for which it fulfills requests. By default, the Have set is empty. Indices must be whole numbers from 0 through 9007199254740992.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

This method sends a NetStatusEvent to the NetGroup's event listener with "NetGroup.Replication.Request" in the code property of the info object.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Manually adds a record specifying that peerID is a member of the group. An immediate connection to it is attempted only if it is needed for the topology.

See also

Manually adds a neighbor by immediately connecting directly to the specified peerID, which must already be in this group. This direct connection may later be dropped if it is not needed for the topology.

See also

Adds objects from startIndex through endIndex, to the set of objects to retrieve. Indices must be whole numbers from 0 through 9007199254740992. By default, the Want set is empty.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

This method sends a NetStatusEvent to the NetGroup's event listener with NetGroup.Replication.Fetch.SendNotify in the info.code property. This event is followed by an NetGroup.Replication.Fetch.Failed or NetGroup.Replication.Fetch.Result event.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Disconnect from the group and close this NetGroup. This NetGroup is not usable after calling this method.

Converts a peerID to a group address suitable for use with the sendToNearest() method.

See also

Denies a request received in a NetStatusEvent NetGroup.Replication.Request for an object previously advertised with addHaveObjects(). The requestor can request this object again unless or until it is withdrawn from the Have set.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Sends a message to all members of a group. To call this method, the GroupSpecifier.postingEnabled property must be true in the groupspec passed to the NetGroup constructor. For more information, see "Post messages to a group" in Flash Media Server Developer’s Guide.

All messages must be unique. A message that is identical to one posted earlier might not be propagated. Use a sequence number to make messages unique.

Message delivery is not ordered. Message delivery is not guaranteed.

Messages are serialized in AMF. The message can be one of the following types: an Object, an int, a Number, or a String. The message cannot be a MovieClip.

This method sends a NetStatusEvent to the NetGroup's event listener with "NetGroup.Posting.Notify" in the info.code property. The "NetGroup.Posting.Notify" event is dispatched to the NetGroup on both the client and the server.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

When you run the application, you can enter any group name into the text input field. The GroupSpecifier class uses the name (along with any GroupSpecifier properties you've set) to create a string which is the perpetually unique name of the group. To connect another client to the group, that client must use the same group name. For example, if client A uses the group name "firstmesh", other clients that want to communicate with client A must also use the group name "firstmesh". If client B uses the group name "kite", it will connect successfully, but it will create a new group and won't be able to communicate with client A or anyone in the "firstmesh" group.

To run this example, add a Button, a Label, a TextInput, and a TextArea component to the Library in Flash Pro.

package  {

    import flash.display.Sprite;
    import flash.events.TextEvent;
    import flash.events.MouseEvent;
	import flash.events.NetStatusEvent;
	import fl.events.ComponentEvent;
	import fl.controls.Label;
	import fl.controls.Button;
	import fl.controls.TextInput;
	import fl.controls.TextArea;
	import flash.text.TextFieldAutoSize;
	import flash.net.*;

	public class NetGroupPostExample extends Sprite{

		private var connectButton:Button;
		private var disconnectButton:Button;
		private var groupNameText:TextInput;
		private var userNameText:TextInput;
		private var chatText:TextInput;
		private var statusLog:TextArea;
		private var groupLabel:Label;
		private var userLabel:Label;

		private var netConnection:NetConnection = null;
		private var netGroup:NetGroup = null;
		private var sequenceNumber:uint = 0;
		private var connected:Boolean = false;
		private var joinedGroup:Boolean = false;

		private const SERVER:String = "rtmfp://fms.example.com/someapp";

		public function NetGroupPostExample() {
			DoUI();
		}

		// Writes messages to the TextArea.
		private function StatusMessage(msg:Object):void{
			statusLog.text += msg;
			statusLog.verticalScrollPosition = statusLog.textHeight;
			statusLog.validateNow();
		}

		// Handles all NetStatusEvents for the NetConnection and the NetGroup.
		// This code includes cases it doesn't handle so you can see the cases
		// and their info objects for learning purposes.
		private function NetStatusHandler(e:NetStatusEvent):void{
			StatusMessage(e.info.code + "\n");
			switch(e.info.code){
				case "NetConnection.Connect.Success":
					connectButton.enabled = false;
					disconnectButton.enabled = true;
					OnConnect();
					break;

				case "NetConnection.Connect.Closed":
					OnDisconnect();
					break;

				case "NetGroup.Connect.Success": // e.info.group
					OnNetGroupConnect();
					break;

				case "NetGroup.Connect.Rejected": // e.info.group
				case "NetGroup.Connect.Failed": // e.info.group
					break;

				case "NetGroup.Posting.Notify": // e.info.message, e.info.messageID
					OnPosting(e.info.message);
					break;

				case "NetStream.MulticastStream.Reset":
				case "NetStream.Buffer.Full":
					break;

				case "NetGroup.SendTo.Notify": // e.info.message, e.info.from, e.info.fromLocal
				case "NetGroup.LocalCoverage.Notify": //
				case "NetGroup.Neighbor.Connect": // e.info.neighbor
				case "NetGroup.Neighbor.Disconnect": // e.info.neighbor
				case "NetGroup.MulticastStream.PublishNotify": // e.info.name
				case "NetGroup.MulticastStream.UnpublishNotify": // e.info.name
				case "NetGroup.Replication.Fetch.SendNotify": // e.info.index
				case "NetGroup.Replication.Fetch.Failed": // e.info.index
				case "NetGroup.Replication.Fetch.Result": // e.info.index, e.info.object
				case "NetGroup.Replication.Request": // e.info.index, e.info.requestID
				default:
					break;
				}
			}
		// Creates a NetConnection to Flash Media Server if the app isn't already connected
		// and if there's a group name in the TextInput field.
		private function DoConnect(e:MouseEvent):void{
			if(!connected && (groupNameText.length > 0)){
				StatusMessage("Connecting to \"" + SERVER + "\" ...\n");
				netConnection = new NetConnection();
				netConnection.addEventListener(NetStatusEvent.NET_STATUS, NetStatusHandler);
				// To connect to Flash Media Server, pass the server name.
				netConnection.connect(SERVER);
			}
			else
			{
				StatusMessage("Enter a group name");
			}
		}

		// Called in the "NetConnection.Connect.Success" case in the NetStatusEvent handler.
		private function OnConnect():void{

			StatusMessage("Connected\n");
			connected = true;

			// Create a GroupSpecifier object to pass to the NetGroup constructor.
			// The GroupSpecifier determines the properties of the group
			var groupSpecifier:GroupSpecifier;
			groupSpecifier = new GroupSpecifier("aslrexample/" + groupNameText.text);
			groupSpecifier.postingEnabled = true;
			groupSpecifier.serverChannelEnabled = true;

			netGroup = new NetGroup(netConnection, groupSpecifier.groupspecWithAuthorizations());
			netGroup.addEventListener(NetStatusEvent.NET_STATUS, NetStatusHandler);

			StatusMessage("Join \"" + groupSpecifier.groupspecWithAuthorizations() + "\"\n");

		}

		private function OnNetGroupConnect():void{
			joinedGroup = true;
		}

		private function DoDisconnect(e:MouseEvent):void{
			if(netConnection){
				netConnection.close();
			}
		}

		private function OnDisconnect():void{
			StatusMessage("Disconnected\n");
			netConnection = null;
			netGroup = null;
			connected = false;
			joinedGroup = false;
			connectButton.enabled = true;
			disconnectButton.enabled = false;
		}

		private function ClearChatText():void{
			chatText.text = "";
		}

		// Called when you the chatText field has focus and you press Enter.
		private function DoPost(e:ComponentEvent):void{
			if(joinedGroup){
				var message:Object = new Object;
				message.user = userNameText.text;
				message.text = chatText.text;
				message.sequence = sequenceNumber++;
				message.sender = netConnection.nearID;

				netGroup.post(message);
				StatusMessage("==> " + chatText.text + "\n");
			} else {
				StatusMessage("Click Connect before sending a chat message");
			}
			ClearChatText();
		}

		private function OnPosting(message:Object):void{
			StatusMessage("<" + message.user + "> " + message.text + "\n");
		}

		private function DoUI():void {

			groupLabel = new Label();
			groupLabel.move(20, 10);
			groupLabel.autoSize = TextFieldAutoSize.LEFT
			groupLabel.text = "Group name:"
			addChild(groupLabel);

			groupNameText = new TextInput();
			groupNameText.move(90, 10);
			groupNameText.text = "channel" + (int(Math.random() * 899) + 101);
			addChild(groupNameText);

        	connectButton = new Button();
			connectButton.addEventListener(MouseEvent.CLICK, DoConnect);
			connectButton.move(205, 10);
			connectButton.label = "Connect";
			addChild(connectButton);

			disconnectButton = new Button();
			disconnectButton.addEventListener(MouseEvent.CLICK, DoDisconnect);
			disconnectButton.move(310, 10);
			disconnectButton.label = "Disconnect";
			disconnectButton.enabled = false;
			addChild(disconnectButton);

			statusLog = new TextArea();
			statusLog.move(30, 38);
			statusLog.width = 360;
			statusLog.height = 215;
			statusLog.editable = false;
			addChild(statusLog);

			userLabel = new Label();
			userLabel.move(20, 270);
			userLabel.autoSize = TextFieldAutoSize.LEFT
			userLabel.text = "User name:"
			addChild(userLabel);

			userNameText = new TextInput();
			userNameText.move(80, 270);
			userNameText.text = "user " + int(Math.random() * 65536);
			addChild(userNameText);

			chatText = new TextInput();
			chatText.addEventListener(ComponentEvent.ENTER, DoPost);
			chatText.move(185, 270);
			chatText.maxChars = 255;
			chatText.width = 215;
			addChild(chatText);

		}

		public function onPlayStatus(info:Object):void {}
		public function onMetaData(info:Object):void {}
		public function onCuePoint(info:Object):void {}
		public function onTextData(info:Object):void {}

	}

}

Removes objects from startIndex through endIndex, from the set of objects this node advertises to neighbors as objects for which it fulfills requests. Indices must be whole numbers from 0 through 9007199254740992.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Removes objects from startIndex through endIndex, from the set of objects to retrieve. Indices must be whole numbers from 0 through 9007199254740992.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Sends a message to all neighbors. Returns NetGroupSendResult.SENT if at least one neighbor was selected.

For more information about routing messages, see "Route messages directly to a peer" in Flash Media Server Developer’s Guide.

When a node receives a message, a NetStatusEvent is sent to the NetGroup's event listener with NetGroup.SendTo.Notify in the code property of the info object.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Sends a message to the neighbor (or local node) nearest to the specified group address. Considers neighbors from the entire ring. Returns NetGroupSendResult.SENT if the message was successfully sent toward its destination.

For more information about routing messages, see "Route messages directly to a peer" in Flash Media Server Developer’s Guide.

When a node receives a message, a NetStatusEvent is sent to the NetGroup's event listener with NetGroup.SendTo.Notify in the code property of the info object.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Sends a message to the neighbor specified by the sendMode parameter. Returns NetGroupSendResult.SENT if the message was successfully sent to the requested destination.

For more information about routing messages, see "Route messages directly to a peer" in Flash Media Server Developer’s Guide.

When a node receives a message, a NetStatusEvent is sent to the NetGroup's event listener with NetGroup.SendTo.Notify in the code property of the info object.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Satisfies the request as received by NetStatusEvent NetGroup.Replication.Request for an object previously advertised with the addHaveObjects() method. The object can be any of the following: An Object, an int, a Number, and a String. The object cannot be a MovieClip.

For more information about object replication, see "Replicate an object within a group" in Flash Media Server Developer’s Guide.

NOTE: Test for the NetGroup.Neighbor.Connect event before calling this method.

See also

Dispatched when a NetGroup object is reporting its status or error condition. The netStatus event contains an info property. The info property is an object that contains information about the event, such as whether a connection attempt succeeded or failed.

Defines the value of the type property of a netStatus event object.

This event has the following properties:

See also