#if !BESTHTTP_DISABLE_WEBSOCKET && (!UNITY_WEBGL || UNITY_EDITOR) using System; using System.IO; namespace BestHTTP.WebSocket.Frames { /// /// Denotes a binary frame. The "Payload data" is arbitrary binary data whose interpretation is solely up to the application layer. /// This is the base class of all other frame writers, as all frame can be represented as a byte array. /// public sealed class WebSocketFrame { public static readonly byte[] NoData = new byte[0]; public WebSocketFrameTypes Type { get; private set; } public bool IsFinal { get; private set; } public byte Header { get; private set; } public byte[] Data { get; private set; } public bool UseExtensions { get; private set; } #region Constructors public WebSocketFrame(WebSocket webSocket, WebSocketFrameTypes type, byte[] data) :this(webSocket, type, data, true) { } public WebSocketFrame(WebSocket webSocket, WebSocketFrameTypes type, byte[] data, bool useExtensions) : this(webSocket, type, data, 0, data != null ? (UInt64)data.Length : 0, true, useExtensions) { } public WebSocketFrame(WebSocket webSocket, WebSocketFrameTypes type, byte[] data, bool isFinal, bool useExtensions) : this(webSocket, type, data, 0, data != null ? (UInt64)data.Length : 0, isFinal, useExtensions) { } public WebSocketFrame(WebSocket webSocket, WebSocketFrameTypes type, byte[] data, UInt64 pos, UInt64 length, bool isFinal, bool useExtensions) { this.Type = type; this.IsFinal = isFinal; this.UseExtensions = useExtensions; if (data != null) { this.Data = new byte[length]; Array.Copy(data, (int)pos, this.Data, 0, (int)length); } else data = NoData; // First byte: Final Bit + Rsv flags + OpCode byte finalBit = (byte)(IsFinal ? 0x80 : 0x0); this.Header = (byte)(finalBit | (byte)Type); if (this.UseExtensions && webSocket != null && webSocket.Extensions != null) { for (int i = 0; i < webSocket.Extensions.Length; ++i) { var ext = webSocket.Extensions[i]; if (ext != null) { this.Header |= ext.GetFrameHeader(this, this.Header); this.Data = ext.Encode(this); } } } } #endregion #region Public Functions public byte[] Get() { if (Data == null) Data = NoData; using (var ms = new MemoryStream(this.Data.Length + 9)) { // For the complete documentation for this section see: // http://tools.ietf.org/html/rfc6455#section-5.2 // Write the header ms.WriteByte(this.Header); // The length of the "Payload data", in bytes: if 0-125, that is the payload length. If 126, the following 2 bytes interpreted as a // 16-bit unsigned integer are the payload length. If 127, the following 8 bytes interpreted as a 64-bit unsigned integer (the // most significant bit MUST be 0) are the payload length. Multibyte length quantities are expressed in network byte order. if (this.Data.Length < 126) ms.WriteByte((byte)(0x80 | (byte)this.Data.Length)); else if (this.Data.Length < UInt16.MaxValue) { ms.WriteByte((byte)(0x80 | 126)); byte[] len = BitConverter.GetBytes((UInt16)this.Data.Length); if (BitConverter.IsLittleEndian) Array.Reverse(len, 0, len.Length); ms.Write(len, 0, len.Length); } else { ms.WriteByte((byte)(0x80 | 127)); byte[] len = BitConverter.GetBytes((UInt64)this.Data.Length); if (BitConverter.IsLittleEndian) Array.Reverse(len, 0, len.Length); ms.Write(len, 0, len.Length); } // All frames sent from the client to the server are masked by a 32-bit value that is contained within the frame. This field is // present if the mask bit is set to 1 and is absent if the mask bit is set to 0. // If the data is being sent by the client, the frame(s) MUST be masked. byte[] mask = BitConverter.GetBytes((Int32)this.GetHashCode()); ms.Write(mask, 0, mask.Length); // Do the masking. for (int i = 0; i < this.Data.Length; ++i) ms.WriteByte((byte)(Data[i] ^ mask[i % 4])); return ms.ToArray(); } } public WebSocketFrame[] Fragment(ushort maxFragmentSize) { if (this.Data == null) return null; // All control frames MUST have a payload length of 125 bytes or less and MUST NOT be fragmented. if (this.Type != WebSocketFrameTypes.Binary && this.Type != WebSocketFrameTypes.Text) return null; if (this.Data.Length <= maxFragmentSize) return null; this.IsFinal = false; // Clear final bit from the header flags this.Header &= 0x7F; // One chunk will remain in this fragment, so we have to allocate one less int count = (this.Data.Length / maxFragmentSize) + (this.Data.Length % maxFragmentSize == 0 ? -1 : 0); WebSocketFrame[] fragments = new WebSocketFrame[count]; // Skip one chunk, for the current one UInt64 pos = maxFragmentSize; while (pos < (UInt64)this.Data.Length) { UInt64 chunkLength = Math.Min(maxFragmentSize, (UInt64)this.Data.Length - pos); fragments[fragments.Length - count--] = new WebSocketFrame(null, WebSocketFrameTypes.Continuation, this.Data, pos, chunkLength, pos + chunkLength >= (UInt64)this.Data.Length, false); pos += chunkLength; } byte[] newData = new byte[maxFragmentSize]; Array.Copy(this.Data, 0, newData, 0, maxFragmentSize); this.Data = newData; return fragments; } #endregion } } #endif