You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

mod_speakerstats_component.lua 13KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373
  1. local util = module:require "util";
  2. local get_room_from_jid = util.get_room_from_jid;
  3. local room_jid_match_rewrite = util.room_jid_match_rewrite;
  4. local is_healthcheck_room = util.is_healthcheck_room;
  5. local process_host_module = util.process_host_module;
  6. local jid_resource = require "util.jid".resource;
  7. local st = require "util.stanza";
  8. local socket = require "socket";
  9. local json = require "util.json";
  10. local um_is_admin = require "core.usermanager".is_admin;
  11. local jid_split = require 'util.jid'.split;
  12. -- we use async to detect Prosody 0.10 and earlier
  13. local have_async = pcall(require, "util.async");
  14. if not have_async then
  15. module:log("warn", "speaker stats will not work with Prosody version 0.10 or less.");
  16. return;
  17. end
  18. local muc_component_host = module:get_option_string("muc_component");
  19. local muc_domain_base = module:get_option_string("muc_mapper_domain_base");
  20. if muc_component_host == nil or muc_domain_base == nil then
  21. module:log("error", "No muc_component specified. No muc to operate on!");
  22. return;
  23. end
  24. local breakout_room_component_host = "breakout." .. muc_domain_base;
  25. module:log("info", "Starting speakerstats for %s", muc_component_host);
  26. local main_muc_service;
  27. local function is_admin(jid)
  28. return um_is_admin(jid, module.host);
  29. end
  30. -- Searches all rooms in the main muc component that holds a breakout room
  31. -- caches it if found so we don't search it again
  32. -- we should not cache objects in _data as this is being serialized when calling room:save()
  33. local function get_main_room(breakout_room)
  34. if breakout_room.main_room then
  35. return breakout_room.main_room;
  36. end
  37. -- let's search all rooms to find the main room
  38. for room in main_muc_service.each_room() do
  39. if room._data and room._data.breakout_rooms_active and room._data.breakout_rooms[breakout_room.jid] then
  40. breakout_room.main_room = room;
  41. return room;
  42. end
  43. end
  44. end
  45. -- receives messages from client currently connected to the room
  46. -- clients indicates their own dominant speaker events
  47. function on_message(event)
  48. -- Check the type of the incoming stanza to avoid loops:
  49. if event.stanza.attr.type == "error" then
  50. return; -- We do not want to reply to these, so leave.
  51. end
  52. local speakerStats
  53. = event.stanza:get_child('speakerstats', 'http://jitsi.org/jitmeet');
  54. if speakerStats then
  55. local roomAddress = speakerStats.attr.room;
  56. local silence = speakerStats.attr.silence == 'true';
  57. local room = get_room_from_jid(room_jid_match_rewrite(roomAddress));
  58. if not room then
  59. module:log("warn", "No room found %s", roomAddress);
  60. return false;
  61. end
  62. if not room.speakerStats then
  63. module:log("warn", "No speakerStats found for %s", roomAddress);
  64. return false;
  65. end
  66. local roomSpeakerStats = room.speakerStats;
  67. local from = event.stanza.attr.from;
  68. local occupant = room:get_occupant_by_real_jid(from);
  69. if not occupant then
  70. module:log("warn", "No occupant %s found for %s", from, roomAddress);
  71. return false;
  72. end
  73. local newDominantSpeaker = roomSpeakerStats[occupant.jid];
  74. local oldDominantSpeakerId = roomSpeakerStats['dominantSpeakerId'];
  75. if oldDominantSpeakerId and occupant.jid ~= oldDominantSpeakerId then
  76. local oldDominantSpeaker = roomSpeakerStats[oldDominantSpeakerId];
  77. if oldDominantSpeaker then
  78. oldDominantSpeaker:setDominantSpeaker(false, false);
  79. end
  80. end
  81. if newDominantSpeaker then
  82. newDominantSpeaker:setDominantSpeaker(true, silence);
  83. end
  84. room.speakerStats['dominantSpeakerId'] = occupant.jid;
  85. end
  86. local newFaceLandmarks = event.stanza:get_child('faceLandmarks', 'http://jitsi.org/jitmeet');
  87. if newFaceLandmarks then
  88. local roomAddress = newFaceLandmarks.attr.room;
  89. local room = get_room_from_jid(room_jid_match_rewrite(roomAddress));
  90. if not room then
  91. module:log("warn", "No room found %s", roomAddress);
  92. return false;
  93. end
  94. if not room.speakerStats then
  95. module:log("warn", "No speakerStats found for %s", roomAddress);
  96. return false;
  97. end
  98. local from = event.stanza.attr.from;
  99. local occupant = room:get_occupant_by_real_jid(from);
  100. if not occupant or not room.speakerStats[occupant.jid] then
  101. module:log("warn", "No occupant %s found for %s", from, roomAddress);
  102. return false;
  103. end
  104. local faceLandmarks = room.speakerStats[occupant.jid].faceLandmarks;
  105. table.insert(faceLandmarks,
  106. {
  107. faceExpression = newFaceLandmarks.attr.faceExpression,
  108. timestamp = tonumber(newFaceLandmarks.attr.timestamp),
  109. duration = tonumber(newFaceLandmarks.attr.duration),
  110. })
  111. end
  112. return true
  113. end
  114. --- Start SpeakerStats implementation
  115. local SpeakerStats = {};
  116. SpeakerStats.__index = SpeakerStats;
  117. function new_SpeakerStats(nick, context_user)
  118. return setmetatable({
  119. totalDominantSpeakerTime = 0;
  120. _dominantSpeakerStart = 0;
  121. _isSilent = false;
  122. _isDominantSpeaker = false;
  123. nick = nick;
  124. context_user = context_user;
  125. displayName = nil;
  126. faceLandmarks = {};
  127. }, SpeakerStats);
  128. end
  129. -- Changes the dominantSpeaker data for current occupant
  130. -- saves start time if it is new dominat speaker
  131. -- or calculates and accumulates time of speaking
  132. function SpeakerStats:setDominantSpeaker(isNowDominantSpeaker, silence)
  133. -- module:log("debug", "set isDominant %s for %s", tostring(isNowDominantSpeaker), self.nick);
  134. local now = socket.gettime()*1000;
  135. if not self:isDominantSpeaker() and isNowDominantSpeaker and not silence then
  136. self._dominantSpeakerStart = now;
  137. elseif self:isDominantSpeaker() then
  138. if not isNowDominantSpeaker then
  139. if not self._isSilent then
  140. local timeElapsed = math.floor(now - self._dominantSpeakerStart);
  141. self.totalDominantSpeakerTime = self.totalDominantSpeakerTime + timeElapsed;
  142. self._dominantSpeakerStart = 0;
  143. end
  144. elseif self._isSilent and not silence then
  145. self._dominantSpeakerStart = now;
  146. elseif not self._isSilent and silence then
  147. local timeElapsed = math.floor(now - self._dominantSpeakerStart);
  148. self.totalDominantSpeakerTime = self.totalDominantSpeakerTime + timeElapsed;
  149. self._dominantSpeakerStart = 0;
  150. end
  151. end
  152. self._isDominantSpeaker = isNowDominantSpeaker;
  153. self._isSilent = silence;
  154. end
  155. -- Returns true if the tracked user is currently a dominant speaker.
  156. function SpeakerStats:isDominantSpeaker()
  157. return self._isDominantSpeaker;
  158. end
  159. -- Returns true if the tracked user is currently silent.
  160. function SpeakerStats:isSilent()
  161. return self._isSilent;
  162. end
  163. --- End SpeakerStats
  164. -- create speakerStats for the room
  165. function room_created(event)
  166. local room = event.room;
  167. if is_healthcheck_room(room.jid) then
  168. return ;
  169. end
  170. room.speakerStats = {};
  171. room.speakerStats.sessionId = room._data.meetingId;
  172. end
  173. -- create speakerStats for the breakout
  174. function breakout_room_created(event)
  175. local room = event.room;
  176. if is_healthcheck_room(room.jid) then
  177. return ;
  178. end
  179. local main_room = get_main_room(room);
  180. room.speakerStats = {};
  181. room.speakerStats.isBreakout = true
  182. room.speakerStats.breakoutRoomId = jid_split(room.jid)
  183. room.speakerStats.sessionId = main_room._data.meetingId;
  184. end
  185. -- Create SpeakerStats object for the joined user
  186. function occupant_joined(event)
  187. local occupant, room = event.occupant, event.room;
  188. if is_healthcheck_room(room.jid) or is_admin(occupant.bare_jid) then
  189. return;
  190. end
  191. local occupant = event.occupant;
  192. local nick = jid_resource(occupant.nick);
  193. if room.speakerStats then
  194. -- lets send the current speaker stats to that user, so he can update
  195. -- its local stats
  196. if next(room.speakerStats) ~= nil then
  197. local users_json = {};
  198. for jid, values in pairs(room.speakerStats) do
  199. -- skip reporting those without a nick('dominantSpeakerId')
  200. -- and skip focus if sneaked into the table
  201. if values and type(values) == 'table' and values.nick ~= nil and values.nick ~= 'focus' then
  202. local totalDominantSpeakerTime = values.totalDominantSpeakerTime;
  203. local faceLandmarks = values.faceLandmarks;
  204. if totalDominantSpeakerTime > 0 or room:get_occupant_jid(jid) == nil or values:isDominantSpeaker()
  205. or next(faceLandmarks) ~= nil then
  206. -- before sending we need to calculate current dominant speaker state
  207. if values:isDominantSpeaker() and not values:isSilent() then
  208. local timeElapsed = math.floor(socket.gettime()*1000 - values._dominantSpeakerStart);
  209. totalDominantSpeakerTime = totalDominantSpeakerTime + timeElapsed;
  210. end
  211. users_json[values.nick] = {
  212. displayName = values.displayName,
  213. totalDominantSpeakerTime = totalDominantSpeakerTime,
  214. faceLandmarks = faceLandmarks
  215. };
  216. end
  217. end
  218. end
  219. if next(users_json) ~= nil then
  220. local body_json = {};
  221. body_json.type = 'speakerstats';
  222. body_json.users = users_json;
  223. local stanza = st.message({
  224. from = module.host;
  225. to = occupant.jid; })
  226. :tag("json-message", {xmlns='http://jitsi.org/jitmeet'})
  227. :text(json.encode(body_json)):up();
  228. room:route_stanza(stanza);
  229. end
  230. end
  231. local context_user = event.origin and event.origin.jitsi_meet_context_user or nil;
  232. room.speakerStats[occupant.jid] = new_SpeakerStats(nick, context_user);
  233. end
  234. end
  235. -- Occupant left set its dominant speaker to false and update the store the
  236. -- display name
  237. function occupant_leaving(event)
  238. local room = event.room;
  239. if is_healthcheck_room(room.jid) then
  240. return;
  241. end
  242. if not room.speakerStats then
  243. return;
  244. end
  245. local occupant = event.occupant;
  246. local speakerStatsForOccupant = room.speakerStats[occupant.jid];
  247. if speakerStatsForOccupant then
  248. speakerStatsForOccupant:setDominantSpeaker(false, false);
  249. -- set display name
  250. local displayName = occupant:get_presence():get_child_text(
  251. 'nick', 'http://jabber.org/protocol/nick');
  252. speakerStatsForOccupant.displayName = displayName;
  253. end
  254. end
  255. -- Conference ended, send speaker stats
  256. function room_destroyed(event)
  257. local room = event.room;
  258. if is_healthcheck_room(room.jid) then
  259. return;
  260. end
  261. module:fire_event("send-speaker-stats", { room = room; roomSpeakerStats = room.speakerStats; });
  262. end
  263. module:hook("message/host", on_message);
  264. function process_main_muc_loaded(main_muc, host_module)
  265. -- the conference muc component
  266. module:log("info", "Hook to muc events on %s", host_module.host);
  267. main_muc_service = main_muc;
  268. module:log("info", "Main muc service %s", main_muc_service)
  269. host_module:hook("muc-room-created", room_created, -1);
  270. host_module:hook("muc-occupant-joined", occupant_joined, -1);
  271. host_module:hook("muc-occupant-pre-leave", occupant_leaving, -1);
  272. host_module:hook("muc-room-destroyed", room_destroyed, -1);
  273. end
  274. function process_breakout_muc_loaded(breakout_muc, host_module)
  275. -- the Breakout muc component
  276. module:log("info", "Hook to muc events on %s", host_module.host);
  277. host_module:hook("muc-room-created", breakout_room_created, -1);
  278. host_module:hook("muc-occupant-joined", occupant_joined, -1);
  279. host_module:hook("muc-occupant-pre-leave", occupant_leaving, -1);
  280. host_module:hook("muc-room-destroyed", room_destroyed, -1);
  281. end
  282. -- process or waits to process the conference muc component
  283. process_host_module(muc_component_host, function(host_module, host)
  284. module:log('info', 'Conference component loaded %s', host);
  285. local muc_module = prosody.hosts[host].modules.muc;
  286. if muc_module then
  287. process_main_muc_loaded(muc_module, host_module);
  288. else
  289. module:log('debug', 'Will wait for muc to be available');
  290. prosody.hosts[host].events.add_handler('module-loaded', function(event)
  291. if (event.module == 'muc') then
  292. process_main_muc_loaded(prosody.hosts[host].modules.muc, host_module);
  293. end
  294. end);
  295. end
  296. end);
  297. -- process or waits to process the breakout rooms muc component
  298. process_host_module(breakout_room_component_host, function(host_module, host)
  299. module:log('info', 'Breakout component loaded %s', host);
  300. local muc_module = prosody.hosts[host].modules.muc;
  301. if muc_module then
  302. process_breakout_muc_loaded(muc_module, host_module);
  303. else
  304. module:log('debug', 'Will wait for muc to be available');
  305. prosody.hosts[host].events.add_handler('module-loaded', function(event)
  306. if (event.module == 'muc') then
  307. process_breakout_muc_loaded(prosody.hosts[host].modules.muc, host_module);
  308. end
  309. end);
  310. end
  311. end);