OpenSim
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Events Macros
PresenceModule.cs
Go to the documentation of this file.
1 /*
2  * Copyright (c) Contributors, http://opensimulator.org/
3  * See CONTRIBUTORS.TXT for a full list of copyright holders.
4  *
5  * Redistribution and use in source and binary forms, with or without
6  * modification, are permitted provided that the following conditions are met:
7  * * Redistributions of source code must retain the above copyright
8  * notice, this list of conditions and the following disclaimer.
9  * * Redistributions in binary form must reproduce the above copyright
10  * notice, this list of conditions and the following disclaimer in the
11  * documentation and/or other materials provided with the distribution.
12  * * Neither the name of the OpenSimulator Project nor the
13  * names of its contributors may be used to endorse or promote products
14  * derived from this software without specific prior written permission.
15  *
16  * THIS SOFTWARE IS PROVIDED BY THE DEVELOPERS ``AS IS'' AND ANY
17  * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
18  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
19  * DISCLAIMED. IN NO EVENT SHALL THE CONTRIBUTORS BE LIABLE FOR ANY
20  * DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
21  * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
22  * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
23  * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
24  * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
25  * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
26  */
27 using System;
28 using System.Collections;
29 using System.Collections.Generic;
30 using System.Net;
31 using System.Reflection;
32 using log4net;
33 using Nini.Config;
34 using Nwc.XmlRpc;
35 using OpenMetaverse;
36 using Mono.Addins;
37 using OpenSim.Framework;
38 using OpenSim.Region.Framework.Interfaces;
39 using OpenSim.Region.Framework.Scenes;
40 using OpenSim.Services.Interfaces;
43 
44 namespace OpenSim.Region.CoreModules.Avatar.InstantMessage
45 {
46  [Extension(Path = "/OpenSim/RegionModules", NodeName = "RegionModule", Id = "PresenceModule")]
48  {
49  private static readonly ILog m_log = LogManager.GetLogger(
50  MethodBase.GetCurrentMethod().DeclaringType);
51 
52 #pragma warning disable 0067
55 #pragma warning restore 0067
56 
57  protected List<Scene> m_Scenes = new List<Scene>();
58 
59  protected IPresenceService m_PresenceService = null;
60 
61  protected IPresenceService PresenceService
62  {
63  get
64  {
65  if (m_PresenceService == null)
66  {
67  if (m_Scenes.Count > 0)
68  m_PresenceService = m_Scenes[0].RequestModuleInterface<IPresenceService>();
69  }
70 
71  return m_PresenceService;
72  }
73  }
74 
75  public void Initialise(IConfigSource config)
76  {
77  }
78 
79  public void AddRegion(Scene scene)
80  {
81  m_Scenes.Add(scene);
82 
83  scene.EventManager.OnNewClient += OnNewClient;
84 
85  scene.RegisterModuleInterface<IPresenceModule>(this);
86  }
87 
88  public void RegionLoaded(Scene scene)
89  {
90  }
91 
92  public void RemoveRegion(Scene scene)
93  {
94  m_Scenes.Remove(scene);
95  }
96 
97  public void PostInitialise()
98  {
99  }
100 
101  public void Close()
102  {
103  }
104 
105  public string Name
106  {
107  get { return "PresenceModule"; }
108  }
109 
110  public Type ReplaceableInterface
111  {
112  get { return null; }
113  }
114 
115  public void RequestBulkPresenceData(UUID[] users)
116  {
117  }
118 
119  public void OnNewClient(IClientAPI client)
120  {
121  client.AddGenericPacketHandler("requestonlinenotification", OnRequestOnlineNotification);
122  }
123 
124  public void OnRequestOnlineNotification(Object sender, string method, List<String> args)
125  {
126  if (!(sender is IClientAPI))
127  return;
128 
129  IClientAPI client = (IClientAPI)sender;
130  m_log.DebugFormat("[PRESENCE MODULE]: OnlineNotification requested by {0}", client.Name);
131 
132  PresenceInfo[] status = PresenceService.GetAgents(args.ToArray());
133 
134  List<UUID> online = new List<UUID>();
135  List<UUID> offline = new List<UUID>();
136 
137  foreach (PresenceInfo pi in status)
138  {
139  UUID uuid = new UUID(pi.UserID);
140  if (!online.Contains(uuid))
141  online.Add(uuid);
142  }
143  foreach (string s in args)
144  {
145  UUID uuid = new UUID(s);
146  if (!online.Contains(uuid) && !offline.Contains(uuid))
147  offline.Add(uuid);
148  }
149 
150  if (online.Count > 0)
151  client.SendAgentOnline(online.ToArray());
152  if (offline.Count > 0)
153  client.SendAgentOffline(offline.ToArray());
154  }
155  }
156 }
void AddRegion(Scene scene)
This is called whenever a Scene is added. For shared modules, this can happen several times...
void OnRequestOnlineNotification(Object sender, string method, List< String > args)
void Initialise(IConfigSource config)
This is called to initialize the region module. For shared modules, this is called exactly once...
OpenSim.Services.Interfaces.GridRegion GridRegion
OpenSim.Services.Interfaces.PresenceInfo PresenceInfo
delegate void BulkPresenceData(PresenceInfo[] info)
void RemoveRegion(Scene scene)
This is called whenever a Scene is removed. For shared modules, this can happen several times...
void RegionLoaded(Scene scene)
This will be called once for every scene loaded. In a shared module this will be multiple times in on...
delegate void PresenceChange(PresenceInfo info)
void PostInitialise()
This is called exactly once after all the shared region-modules have been instanciated and IRegionMod...
void Close()
This is the inverse to Initialise. After a Close(), this instance won't be usable anymore...