123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255 |
- // ----------------------------------------------------------------------------------------------------------------------
- // <summary>The Photon Chat Api enables clients to connect to a chat server and communicate with other clients.</summary>
- // <remarks>ChatClient is the main class of this api.</remarks>
- // <copyright company="Exit Games GmbH">Photon Chat Api - Copyright (C) 2014 Exit Games GmbH</copyright>
- // ----------------------------------------------------------------------------------------------------------------------
- #if UNITY_4_7 || UNITY_5 || UNITY_5_3_OR_NEWER
- #define SUPPORTED_UNITY
- #endif
- namespace Photon.Chat
- {
- using System.Collections.Generic;
- using System.Text;
- #if SUPPORTED_UNITY || NETFX_CORE
- using Hashtable = ExitGames.Client.Photon.Hashtable;
- using SupportClass = ExitGames.Client.Photon.SupportClass;
- #endif
- /// <summary>
- /// A channel of communication in Photon Chat, updated by ChatClient and provided as READ ONLY.
- /// </summary>
- /// <remarks>
- /// Contains messages and senders to use (read!) and display by your GUI.
- /// Access these by:
- /// ChatClient.PublicChannels
- /// ChatClient.PrivateChannels
- /// </remarks>
- public class ChatChannel
- {
- /// <summary>Name of the channel (used to subscribe and unsubscribe).</summary>
- public readonly string Name;
- /// <summary>Senders of messages in chronological order. Senders and Messages refer to each other by index. Senders[x] is the sender of Messages[x].</summary>
- public readonly List<string> Senders = new List<string>();
- /// <summary>Messages in chronological order. Senders and Messages refer to each other by index. Senders[x] is the sender of Messages[x].</summary>
- public readonly List<object> Messages = new List<object>();
- /// <summary>If greater than 0, this channel will limit the number of messages, that it caches locally.</summary>
- public int MessageLimit;
- /// <summary>Unique channel ID.</summary>
- public int ChannelID;
- /// <summary>Is this a private 1:1 channel?</summary>
- public bool IsPrivate { get; protected internal set; }
- /// <summary>Count of messages this client still buffers/knows for this channel.</summary>
- public int MessageCount { get { return this.Messages.Count; } }
- /// <summary>
- /// ID of the last message received.
- /// </summary>
- public int LastMsgId { get; protected set; }
- private Dictionary<object, object> properties;
- /// <summary>Whether or not this channel keeps track of the list of its subscribers.</summary>
- public bool PublishSubscribers { get; protected set; }
- /// <summary>Maximum number of channel subscribers. 0 means infinite.</summary>
- public int MaxSubscribers { get; protected set; }
- /// <summary>Subscribed users.</summary>
- public readonly HashSet<string> Subscribers = new HashSet<string>();
- /// <summary> Properties of subscribers </summary>
- private Dictionary<string, Dictionary<object, object>> usersProperties;
- /// <summary>Used internally to create new channels. This does NOT create a channel on the server! Use ChatClient.Subscribe.</summary>
- public ChatChannel(string name)
- {
- this.Name = name;
- }
-
- /// <summary>Used internally to add messages to this channel.</summary>
- public void Add(string sender, object message, int msgId)
- {
- this.Senders.Add(sender);
- this.Messages.Add(message);
- this.LastMsgId = msgId;
- this.TruncateMessages();
- }
- /// <summary>Used internally to add messages to this channel.</summary>
- public void Add(string[] senders, object[] messages, int lastMsgId)
- {
- this.Senders.AddRange(senders);
- this.Messages.AddRange(messages);
- this.LastMsgId = lastMsgId;
- this.TruncateMessages();
- }
- /// <summary>Reduces the number of locally cached messages in this channel to the MessageLimit (if set).</summary>
- public void TruncateMessages()
- {
- if (this.MessageLimit <= 0 || this.Messages.Count <= this.MessageLimit)
- {
- return;
- }
- int excessCount = this.Messages.Count - this.MessageLimit;
- this.Senders.RemoveRange(0, excessCount);
- this.Messages.RemoveRange(0, excessCount);
- }
- /// <summary>Clear the local cache of messages currently stored. This frees memory but doesn't affect the server.</summary>
- public void ClearMessages()
- {
- this.Senders.Clear();
- this.Messages.Clear();
- }
- /// <summary>Provides a string-representation of all messages in this channel.</summary>
- /// <returns>All known messages in format "Sender: Message", line by line.</returns>
- public string ToStringMessages()
- {
- StringBuilder txt = new StringBuilder();
- for (int i = 0; i < this.Messages.Count; i++)
- {
- txt.AppendLine(string.Format("{0}: {1}", this.Senders[i], this.Messages[i]));
- }
- return txt.ToString();
- }
- internal void ReadChannelProperties(Dictionary<object, object> newProperties)
- {
- if (newProperties != null && newProperties.Count > 0)
- {
- if (this.properties == null)
- {
- this.properties = new Dictionary<object, object>(newProperties.Count);
- }
- foreach (var pair in newProperties)
- {
- if (pair.Value == null)
- {
- this.properties.Remove(pair.Key);
- }
- else
- {
- this.properties[pair.Key] = pair.Value;
- }
- }
- object temp;
- if (this.properties.TryGetValue(ChannelWellKnownProperties.PublishSubscribers, out temp))
- {
- this.PublishSubscribers = (bool)temp;
- }
- if (this.properties.TryGetValue(ChannelWellKnownProperties.MaxSubscribers, out temp))
- {
- this.MaxSubscribers = (int)temp;
- }
- }
- }
- internal bool AddSubscribers(string[] users)
- {
- if (users == null)
- {
- return false;
- }
- bool result = true;
- for (int i = 0; i < users.Length; i++)
- {
- if (!this.Subscribers.Add(users[i]))
- {
- result = false;
- }
- }
- return result;
- }
- internal bool AddSubscriber(string userId)
- {
- return this.Subscribers.Add(userId);
- }
- internal bool RemoveSubscriber(string userId)
- {
- if (this.usersProperties != null)
- {
- this.usersProperties.Remove(userId);
- }
- return this.Subscribers.Remove(userId);
- }
- #if CHAT_EXTENDED
- internal void ReadUserProperties(string userId, Dictionary<object, object> changedProperties)
- {
- if (this.usersProperties == null)
- {
- this.usersProperties = new Dictionary<string, Dictionary<object, object>>();
- }
- Dictionary<object, object> userProperties;
- if (!this.usersProperties.TryGetValue(userId, out userProperties))
- {
- userProperties = new Dictionary<object, object>();
- this.usersProperties.Add(userId, userProperties);
- }
- foreach (var property in changedProperties)
- {
- //UnityEngine.Debug.LogFormat("User {0} property {1} = {2}", userId, property.Key, property.Value);
- if (property.Value == null)
- {
- userProperties.Remove(property.Key);
- }
- else
- {
- userProperties[property.Key] = property.Value;
- }
- }
- }
-
- internal bool TryGetChannelProperty<T>(object propertyKey, out T propertyValue)
- {
- propertyValue = default;
- object temp;
- if (properties != null && properties.TryGetValue(propertyKey, out temp) && temp is T)
- {
- propertyValue = (T)temp;
- return true;
- }
- return false;
- }
- internal bool TryGetUserProperty<T>(string userId, object propertyKey, out T propertyValue)
- {
- propertyValue = default;
- object temp;
- Dictionary<object, object> userProperties;
- if (this.usersProperties != null && usersProperties.TryGetValue(userId, out userProperties) && userProperties.TryGetValue(propertyKey, out temp) && temp is T)
- {
- propertyValue = (T)temp;
- return true;
- }
- return false;
- }
- public bool TryGetCustomChannelProperty<T>(string propertyKey, out T propertyValue)
- {
- return this.TryGetChannelProperty(propertyKey, out propertyValue);
- }
- public bool TryGetCustomUserProperty<T>(string userId, string propertyKey, out T propertyValue)
- {
- return this.TryGetUserProperty(userId, propertyKey, out propertyValue);
- }
- #endif
- }
- }
|