Merge pull request #62 from mattleibow/xamarin-component

Xamarin Component

Author: mattqs

DETAILS.md

@@ -0,0 +1,79 @@
+# Socket.IO .NET
+
+Socket.IO enables real-time bidirectional event-based communication.
+It works on every platform, browser or device, focusing equally on reliability and speed.
+
+ * **Real-time analytics**  
+   Push data to clients that gets represented as real-time counters, charts or logs.
+ * **Instant messaging and chat**  
+   Socket.IO's "Hello world" is a chat app in just a few lines of code.
+ * **Binary streaming**  
+   Starting in 1.0, it's possible to send any blob back and forth: image, audio, video.
+ * **Document collaboration**  
+   Allow users to concurrently edit a document and see each other's changes.
+   
+> **USED BY EVERYONE**  
+> From Microsoft Office, Yammer, Zendesk, Trello... to hackathon winners and little startups.
+
+> **IMMENSELY POWERFUL, YET EASY TO USE**  
+> Our getting started guide will show you how to create lots of amazing applications in fewer 
+> than 200 lines of code.
+
+## Connect to Server
+
+Connecting to a Socket.IO server is just two lines:
+
+    // connect to a Socket.IO server
+    socket = IO.Socket("http://chat.socket.io/");
+    socket.Connect();
+    
+    // disconnect from the server
+    socket.Close();
+
+## Subscribe to Events
+
+Listening for messages from the server is easy,all we need to do is 
+attach a delegate to the event name using the `On` method.
+
+The `data` received from the http://chat.socket.io/ server is a `JToken` value:
+
+    // whenever the server emits "login", print the login message
+    socket.On("login", data => {
+        connected = true;
+        
+        // get the json data from the server message
+        var jobject = data as JToken;
+        
+        // get the number of users
+        var numUsers = jobject.Value<int>("numUsers");
+        
+        // display the welcome message...
+    });
+    
+    // whenever the server emits "new message", update the chat body
+    socket.On("new message", data => {
+        // get the json data from the server message
+        var jobject = data as JToken;
+        
+        // get the message data values
+        var username = jobject.Value<string>("username");
+        var message = jobject.Value<string>("message");
+        
+        // display message...
+    });
+
+## Send a Message
+
+Sending a message to the server is just a single line of code that makes use of the 
+`Emit` method:
+
+    // we can send messages to the server
+    socket.Emit("add user", "username");
+    if (connected) {
+       socket.Emit("new message", "This is a message from Xamarin.Android...");
+    }
+    
+    // or we can just send events
+    socket.Emit("typing");
+    // cancel that typing event
+    socket.Emit("stop typing");

LICENSE.md

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2015 Quobject
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

Src/SocketIoClientDotNet.Sample.Xamarin-Android/Assets/AboutAssets.txt

@@ -0,0 +1,19 @@
+Any raw assets you want to be deployed with your application can be placed in
+this directory (and child directories) and given a Build Action of "AndroidAsset".
+
+These files will be deployed with you package and will be accessible using Android's
+AssetManager, like this:
+
+public class ReadAsset : Activity
+{
+	protected override void OnCreate (Bundle bundle)
+	{
+		base.OnCreate (bundle);
+
+		InputStream input = Assets.Open ("my_asset.txt");
+	}
+}
+
+Additionally, some Android functions will automatically load asset files:
+
+Typeface tf = Typeface.CreateFromAsset (Context.Assets, "fonts/samplefont.ttf");

Src/SocketIoClientDotNet.Sample.Xamarin-Android/ChatAdapter.cs

@@ -0,0 +1,79 @@
+using System.Collections.Generic;
+using Android.Graphics;
+using Android.Views;
+using Android.Widget;
+
+namespace SocketIoClientDotNet.Sample.Xamarin_Android
+{
+    public class ChatAdapter : BaseAdapter<ChatAdapter.ChatItem>
+    {
+        private readonly List<ChatAdapter.ChatItem> chatItems;
+
+        public ChatAdapter(List<ChatAdapter.ChatItem> chatItems)
+        {
+            this.chatItems = chatItems;
+        }
+
+        public override ChatAdapter.ChatItem this[int position]
+        {
+            get { return chatItems[position]; }
+        }
+
+        public override int Count
+        {
+            get { return chatItems.Count; }
+        }
+
+        public override long GetItemId(int position)
+        {
+            return position;
+        }
+
+        public override View GetView(int position, View convertView, ViewGroup parent)
+        {
+            var item = chatItems[position];
+            var layout = item.Username == null 
+                ? Android.Resource.Layout.SimpleListItem1 
+                : Android.Resource.Layout.SimpleListItem2;
+
+            var inflater = LayoutInflater.From(parent.Context);
+
+            if (convertView == null || (int)convertView.Tag != layout)
+            {
+                convertView = inflater.Inflate(layout, parent, false);
+                convertView.Tag = layout;
+            }
+
+            if (item.Username == null)
+            {
+                var text1 = convertView.FindViewById<TextView>(Android.Resource.Id.Text1);
+                
+                text1.Text = item.Message;
+            }
+            else
+            {
+                var text1 = convertView.FindViewById<TextView>(Android.Resource.Id.Text1);
+                var text2 = convertView.FindViewById<TextView>(Android.Resource.Id.Text2);
+
+                text1.Typeface = Typeface.DefaultBold;
+                text1.Text = item.Username;
+                text2.Text = item.Message;
+            }
+
+            return convertView;
+        }
+
+        public struct ChatItem
+        {
+            public ChatItem(string username, string message)
+                : this()
+            {
+                Username = username;
+                Message = message;
+            }
+
+            public string Username { get; set; }
+            public string Message { get; set; }
+        }
+    }
+}