summaryrefslogtreecommitdiff
path: root/src/SMAPI/Events/ModMessageReceivedEventArgs.cs
blob: d75a754086e0161c7e2265605e1aefb39ec137ac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
using System;
using StardewModdingAPI.Framework.Networking;
using StardewModdingAPI.Toolkit.Serialization;

namespace StardewModdingAPI.Events
{
    /// <summary>Event arguments for an <see cref="IMultiplayerEvents.ModMessageReceived"/> event.</summary>
    public class ModMessageReceivedEventArgs : EventArgs
    {
        /*********
        ** Fields
        *********/
        /// <summary>The underlying message model.</summary>
        private readonly ModMessageModel Message;

        /// <summary>The JSON helper used to deserialize models.</summary>
        private readonly JsonHelper JsonHelper;


        /*********
        ** Accessors
        *********/
        /// <summary>The unique ID of the player from whose computer the message was sent.</summary>
        public long FromPlayerID => this.Message.FromPlayerID;

        /// <summary>The unique ID of the mod which sent the message.</summary>
        public string FromModID => this.Message.FromModID;

        /// <summary>A message type which can be used to decide whether it's the one you want to handle, like <c>SetPlayerLocation</c>. This doesn't need to be globally unique, so mods should check the <see cref="FromModID"/>.</summary>
        public string Type => this.Message.Type;


        /*********
        ** Public methods
        *********/
        /// <summary>Construct an instance.</summary>
        /// <param name="message">The received message.</param>
        /// <param name="jsonHelper">The JSON helper used to deserialize models.</param>
        internal ModMessageReceivedEventArgs(ModMessageModel message, JsonHelper jsonHelper)
        {
            this.Message = message;
            this.JsonHelper = jsonHelper;
        }

        /// <summary>Read the message data into the given model type.</summary>
        /// <typeparam name="TModel">The message model type.</typeparam>
        public TModel ReadAs<TModel>()
        {
            return this.Message.Data.ToObject<TModel>(this.JsonHelper.GetSerializer());
        }
    }
}