4 Replies Latest reply on Jan 9, 2011 8:11 PM by Michael Thornburgh

    Cirrus Documentation?

    vinceaction Level 1

      Where are all of the commands to successfully use Cirrus? Is there some kinda documentation or is it all in Flash.net? I have used socket servers before, and of course those all come with nice docs, but is Cirrus all about figuring it out yourself by going through the commands in Flash.net?

       

      Thanks.

        • 1. Re: Cirrus Documentation?
          Michael Thornburgh Adobe Employee

          Cirrus doesn't respond to any commands as you might think of them.  technically it responds to "connect" (issued when you use NetConnection.connect() to Cirrus) and "setPeerInfo" (issued automatically by Flash Player after a successful connect to an RTMFP server).  but all NetConnection.call() commands are ignored by Cirrus.

           

          at this time, only reference documentation exists for the client-side classes you use for client-server and P2P communication using RTMFP.  take a look at NetConnection, NetStream, NetGroup, and GroupSpecifier.

           

          a number of tutorials and examples exist.  there is one linked to from the main Cirrus page written by Jozsef Vass:

           

             http://www.adobe.com/devnet/flashplayer/articles/rtmfp_cirrus_app.html

           

          and another by Jozsef:

           

             http://www.adobe.com/devnet/flashmediaserver/articles/real-time-collaboration.html

           

          Tom Krcha has written numerous articles about RTMFP on his blog at

           

             http://www.flashrealtime.com/

           

          this thread has some links:

           

             http://forums.adobe.com/thread/756550?tstart=0

           

          and this thread, where i posted links to materials i presented at MAX 2009 and 2010:

           

             http://forums.adobe.com/thread/766959?tstart=0

          1 person found this helpful
          • 2. Re: Cirrus Documentation?
            vinceaction Level 1

            Thank you Michael. I will begin my research

            • 3. Re: Cirrus Documentation?
              Véronique Brossier Level 1

              Michael,

               

              Can you please clarify a point?

               

              With RTMFP, is it possible to send a stream (let's say one-to-many) without having to use the peerID and receivers to know the peerID? Basically just using Cirrus and the same group name for rendez-vous and then streaming from one client to the others using "publish" and "play". It doesn't seem to work for me.

               

              About exchange of PeerID, what would be your recommendation approach to do so?

               

              I am focusing on AIR for Android development so, right on, I can IM the peerID to another peer but, of course, this assumes that I know them already.

               

              Thanks.

              • 4. Re: Cirrus Documentation?
                Michael Thornburgh Adobe Employee

                we discussed this privately, but for the other folks reading this thread: you need to set GroupSpecifier.serverChannelEnabled=true to have the server perform automatic group bootstrapping for your group members.  otherwise, for N peers that are all trying to be in group X, you'll have N 1-member disjoint groups each in their own group X.  the alternative is to write your own group bootstrap/membership tracking service to do the same thing; however, i think it's much more convenient to just use the automatic group bootstrap service on Cirrus (or the corresponding function on FMS if that's what you're using).

                 

                whenever you join a group, you start out in the "i'm all alone in my group" state.  think of it like bubbles.  when bubbles touch, they merge together into a single larger bubble.  but you need to touch that other bubble in at least one spot.  both Cirrus and FMS can help out with that.

                 

                for finding/exchanging peerIDs, when using Cirrus you would typically run a web service somewhere to translate (for example) names to peerIDs, and provide a registration service to set the current peerID for a name.  the VideoPhoneLabs example on the Cirrus labs page includes such a simple web service written in Python and using SQLite.  if you're using FMS then you can just whip up some SSAS.