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.

JitsiConference.js 141KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920292129222923292429252926292729282929293029312932293329342935293629372938293929402941294229432944294529462947294829492950295129522953295429552956295729582959296029612962296329642965296629672968296929702971297229732974297529762977297829792980298129822983298429852986298729882989299029912992299329942995299629972998299930003001300230033004300530063007300830093010301130123013301430153016301730183019302030213022302330243025302630273028302930303031303230333034303530363037303830393040304130423043304430453046304730483049305030513052305330543055305630573058305930603061306230633064306530663067306830693070307130723073307430753076307730783079308030813082308330843085308630873088308930903091309230933094309530963097309830993100310131023103310431053106310731083109311031113112311331143115311631173118311931203121312231233124312531263127312831293130313131323133313431353136313731383139314031413142314331443145314631473148314931503151315231533154315531563157315831593160316131623163316431653166316731683169317031713172317331743175317631773178317931803181318231833184318531863187318831893190319131923193319431953196319731983199320032013202320332043205320632073208320932103211321232133214321532163217321832193220322132223223322432253226322732283229323032313232323332343235323632373238323932403241324232433244324532463247324832493250325132523253325432553256325732583259326032613262326332643265326632673268326932703271327232733274327532763277327832793280328132823283328432853286328732883289329032913292329332943295329632973298329933003301330233033304330533063307330833093310331133123313331433153316331733183319332033213322332333243325332633273328332933303331333233333334333533363337333833393340334133423343334433453346334733483349335033513352335333543355335633573358335933603361336233633364336533663367336833693370337133723373337433753376337733783379338033813382338333843385338633873388338933903391339233933394339533963397339833993400340134023403340434053406340734083409341034113412341334143415341634173418341934203421342234233424342534263427342834293430343134323433343434353436343734383439344034413442344334443445344634473448344934503451345234533454345534563457345834593460346134623463346434653466346734683469347034713472347334743475347634773478347934803481348234833484348534863487348834893490349134923493349434953496349734983499350035013502350335043505350635073508350935103511351235133514351535163517351835193520352135223523352435253526352735283529353035313532353335343535353635373538353935403541354235433544354535463547354835493550355135523553355435553556355735583559356035613562356335643565356635673568356935703571357235733574357535763577357835793580358135823583358435853586358735883589359035913592359335943595359635973598359936003601360236033604360536063607360836093610361136123613361436153616361736183619362036213622362336243625362636273628362936303631363236333634363536363637363836393640364136423643364436453646364736483649365036513652365336543655365636573658365936603661366236633664366536663667366836693670367136723673367436753676367736783679368036813682368336843685368636873688368936903691369236933694369536963697369836993700370137023703370437053706370737083709371037113712371337143715371637173718371937203721372237233724372537263727372837293730373137323733373437353736373737383739374037413742374337443745374637473748374937503751375237533754375537563757375837593760376137623763376437653766376737683769377037713772377337743775377637773778377937803781378237833784378537863787378837893790379137923793379437953796379737983799380038013802380338043805380638073808380938103811381238133814381538163817381838193820382138223823382438253826382738283829383038313832383338343835383638373838383938403841384238433844384538463847384838493850385138523853385438553856385738583859386038613862386338643865386638673868386938703871387238733874387538763877387838793880388138823883388438853886388738883889389038913892389338943895389638973898389939003901390239033904390539063907390839093910391139123913391439153916391739183919392039213922392339243925392639273928392939303931393239333934393539363937393839393940394139423943394439453946394739483949395039513952395339543955395639573958395939603961396239633964396539663967396839693970397139723973397439753976397739783979398039813982398339843985398639873988398939903991399239933994399539963997399839994000400140024003400440054006400740084009401040114012401340144015401640174018401940204021402240234024402540264027402840294030403140324033403440354036403740384039404040414042404340444045404640474048404940504051405240534054405540564057405840594060406140624063406440654066406740684069407040714072407340744075407640774078407940804081408240834084408540864087408840894090409140924093409440954096409740984099410041014102410341044105410641074108410941104111411241134114411541164117411841194120412141224123412441254126412741284129413041314132413341344135413641374138413941404141414241434144414541464147414841494150415141524153415441554156415741584159416041614162416341644165416641674168416941704171417241734174417541764177417841794180418141824183418441854186418741884189419041914192419341944195419641974198419942004201420242034204420542064207420842094210421142124213421442154216421742184219422042214222
  1. import { getLogger } from '@jitsi/logger';
  2. import EventEmitter from 'events';
  3. import $ from 'jquery';
  4. import isEqual from 'lodash.isequal';
  5. import { Strophe } from 'strophe.js';
  6. import * as JitsiConferenceErrors from './JitsiConferenceErrors';
  7. import JitsiConferenceEventManager from './JitsiConferenceEventManager';
  8. import * as JitsiConferenceEvents from './JitsiConferenceEvents';
  9. import JitsiParticipant from './JitsiParticipant';
  10. import JitsiTrackError from './JitsiTrackError';
  11. import * as JitsiTrackErrors from './JitsiTrackErrors';
  12. import * as JitsiTrackEvents from './JitsiTrackEvents';
  13. import authenticateAndUpgradeRole from './authenticateAndUpgradeRole';
  14. import { CodecSelection } from './modules/RTC/CodecSelection';
  15. import RTC from './modules/RTC/RTC';
  16. import { SS_DEFAULT_FRAME_RATE } from './modules/RTC/ScreenObtainer';
  17. import browser from './modules/browser';
  18. import ConnectionQuality from './modules/connectivity/ConnectionQuality';
  19. import IceFailedHandling
  20. from './modules/connectivity/IceFailedHandling';
  21. import ParticipantConnectionStatusHandler
  22. from './modules/connectivity/ParticipantConnectionStatus';
  23. import * as DetectionEvents from './modules/detection/DetectionEvents';
  24. import NoAudioSignalDetection from './modules/detection/NoAudioSignalDetection';
  25. import P2PDominantSpeakerDetection from './modules/detection/P2PDominantSpeakerDetection';
  26. import VADAudioAnalyser from './modules/detection/VADAudioAnalyser';
  27. import VADNoiseDetection from './modules/detection/VADNoiseDetection';
  28. import VADTalkMutedDetection from './modules/detection/VADTalkMutedDetection';
  29. import { E2EEncryption } from './modules/e2ee/E2EEncryption';
  30. import E2ePing from './modules/e2eping/e2eping';
  31. import Jvb121EventGenerator from './modules/event/Jvb121EventGenerator';
  32. import FeatureFlags from './modules/flags/FeatureFlags';
  33. import ReceiveVideoController from './modules/qualitycontrol/ReceiveVideoController';
  34. import SendVideoController from './modules/qualitycontrol/SendVideoController';
  35. import RecordingManager from './modules/recording/RecordingManager';
  36. import Settings from './modules/settings/Settings';
  37. import AudioOutputProblemDetector from './modules/statistics/AudioOutputProblemDetector';
  38. import AvgRTPStatsReporter from './modules/statistics/AvgRTPStatsReporter';
  39. import SpeakerStatsCollector from './modules/statistics/SpeakerStatsCollector';
  40. import Statistics from './modules/statistics/statistics';
  41. import Transcriber from './modules/transcription/transcriber';
  42. import GlobalOnErrorHandler from './modules/util/GlobalOnErrorHandler';
  43. import RandomUtil from './modules/util/RandomUtil';
  44. import ComponentsVersions from './modules/version/ComponentsVersions';
  45. import VideoSIPGW from './modules/videosipgw/VideoSIPGW';
  46. import * as VideoSIPGWConstants from './modules/videosipgw/VideoSIPGWConstants';
  47. import SignalingLayerImpl from './modules/xmpp/SignalingLayerImpl';
  48. import {
  49. FEATURE_E2EE,
  50. FEATURE_JIGASI,
  51. JITSI_MEET_MUC_TYPE
  52. } from './modules/xmpp/xmpp';
  53. import BridgeVideoType from './service/RTC/BridgeVideoType';
  54. import CodecMimeType from './service/RTC/CodecMimeType';
  55. import { MediaType } from './service/RTC/MediaType';
  56. import RTCEvents from './service/RTC/RTCEvents';
  57. import { getSourceNameForJitsiTrack } from './service/RTC/SignalingLayer';
  58. import { VideoType } from './service/RTC/VideoType';
  59. import {
  60. ACTION_JINGLE_RESTART,
  61. ACTION_JINGLE_SI_RECEIVED,
  62. ACTION_JINGLE_SI_TIMEOUT,
  63. ACTION_JINGLE_TERMINATE,
  64. ACTION_P2P_DECLINED,
  65. ACTION_P2P_ESTABLISHED,
  66. ACTION_P2P_FAILED,
  67. ACTION_P2P_SWITCH_TO_JVB,
  68. ICE_ESTABLISHMENT_DURATION_DIFF,
  69. createConferenceEvent,
  70. createJingleEvent,
  71. createP2PEvent
  72. } from './service/statistics/AnalyticsEvents';
  73. import { XMPPEvents } from './service/xmpp/XMPPEvents';
  74. const logger = getLogger(__filename);
  75. /**
  76. * How long since Jicofo is supposed to send a session-initiate, before
  77. * {@link ACTION_JINGLE_SI_TIMEOUT} analytics event is sent (in ms).
  78. * @type {number}
  79. */
  80. const JINGLE_SI_TIMEOUT = 5000;
  81. /**
  82. * Creates a JitsiConference object with the given name and properties.
  83. * Note: this constructor is not a part of the public API (objects should be
  84. * created using JitsiConnection.createConference).
  85. * @param options.config properties / settings related to the conference that
  86. * will be created.
  87. * @param options.name the name of the conference
  88. * @param options.connection the JitsiConnection object for this
  89. * JitsiConference.
  90. * @param {number} [options.config.avgRtpStatsN=15] how many samples are to be
  91. * collected by {@link AvgRTPStatsReporter}, before arithmetic mean is
  92. * calculated and submitted to the analytics module.
  93. * @param {boolean} [options.config.enableIceRestart=false] - enables the ICE
  94. * restart logic.
  95. * @param {boolean} [options.config.p2p.enabled] when set to <tt>true</tt>
  96. * the peer to peer mode will be enabled. It means that when there are only 2
  97. * participants in the conference an attempt to make direct connection will be
  98. * made. If the connection succeeds the conference will stop sending data
  99. * through the JVB connection and will use the direct one instead.
  100. * @param {number} [options.config.p2p.backToP2PDelay=5] a delay given in
  101. * seconds, before the conference switches back to P2P, after the 3rd
  102. * participant has left the room.
  103. * @param {number} [options.config.channelLastN=-1] The requested amount of
  104. * videos are going to be delivered after the value is in effect. Set to -1 for
  105. * unlimited or all available videos.
  106. * @param {number} [options.config.forceJVB121Ratio]
  107. * "Math.random() < forceJVB121Ratio" will determine whether a 2 people
  108. * conference should be moved to the JVB instead of P2P. The decision is made on
  109. * the responder side, after ICE succeeds on the P2P connection.
  110. * @constructor
  111. *
  112. * FIXME Make all methods which are called from lib-internal classes
  113. * to non-public (use _). To name a few:
  114. * {@link JitsiConference.onLocalRoleChanged}
  115. * {@link JitsiConference.onUserRoleChanged}
  116. * {@link JitsiConference.onMemberLeft}
  117. * and so on...
  118. */
  119. export default function JitsiConference(options) {
  120. if (!options.name || options.name.toLowerCase() !== options.name.toString()) {
  121. const errmsg
  122. = 'Invalid conference name (no conference name passed or it '
  123. + 'contains invalid characters like capital letters)!';
  124. logger.error(errmsg);
  125. throw new Error(errmsg);
  126. }
  127. this.connection = options.connection;
  128. this.xmpp = this.connection?.xmpp;
  129. if (this.xmpp.isRoomCreated(options.name, options.customDomain)) {
  130. const errmsg = 'A conference with the same name has already been created!';
  131. delete this.connection;
  132. delete this.xmpp;
  133. logger.error(errmsg);
  134. throw new Error(errmsg);
  135. }
  136. this.eventEmitter = new EventEmitter();
  137. this.options = options;
  138. this.eventManager = new JitsiConferenceEventManager(this);
  139. this.participants = {};
  140. /**
  141. * The signaling layer instance.
  142. * @type {SignalingLayerImpl}
  143. * @private
  144. */
  145. this._signalingLayer = new SignalingLayerImpl();
  146. this._init(options);
  147. this.componentsVersions = new ComponentsVersions(this);
  148. /**
  149. * Jingle session instance for the JVB connection.
  150. * @type {JingleSessionPC}
  151. */
  152. this.jvbJingleSession = null;
  153. this.lastDominantSpeaker = null;
  154. this.dtmfManager = null;
  155. this.somebodySupportsDTMF = false;
  156. this.authEnabled = false;
  157. this.startAudioMuted = false;
  158. this.startVideoMuted = false;
  159. this.startMutedPolicy = {
  160. audio: false,
  161. video: false
  162. };
  163. this.isMutedByFocus = false;
  164. // when muted by focus we receive the jid of the initiator of the mute
  165. this.mutedByFocusActor = null;
  166. this.isVideoMutedByFocus = false;
  167. // when video muted by focus we receive the jid of the initiator of the mute
  168. this.mutedVideoByFocusActor = null;
  169. // Flag indicates if the 'onCallEnded' method was ever called on this
  170. // instance. Used to log extra analytics event for debugging purpose.
  171. // We need to know if the potential issue happened before or after
  172. // the restart.
  173. this.wasStopped = false;
  174. // Conference properties, maintained by jicofo.
  175. this.properties = {};
  176. /**
  177. * The object which monitors local and remote connection statistics (e.g.
  178. * sending bitrate) and calculates a number which represents the connection
  179. * quality.
  180. */
  181. this.connectionQuality
  182. = new ConnectionQuality(this, this.eventEmitter, options);
  183. /**
  184. * Reports average RTP statistics to the analytics module.
  185. * @type {AvgRTPStatsReporter}
  186. */
  187. this.avgRtpStatsReporter
  188. = new AvgRTPStatsReporter(this, options.config.avgRtpStatsN || 15);
  189. /**
  190. * Detects issues with the audio of remote participants.
  191. * @type {AudioOutputProblemDetector}
  192. */
  193. if (!options.config.disableAudioLevels) {
  194. this._audioOutputProblemDetector = new AudioOutputProblemDetector(this);
  195. }
  196. /**
  197. * Indicates whether the connection is interrupted or not.
  198. */
  199. this.isJvbConnectionInterrupted = false;
  200. /**
  201. * The object which tracks active speaker times
  202. */
  203. this.speakerStatsCollector = new SpeakerStatsCollector(this);
  204. /* P2P related fields below: */
  205. /**
  206. * Stores reference to deferred start P2P task. It's created when 3rd
  207. * participant leaves the room in order to avoid ping pong effect (it
  208. * could be just a page reload).
  209. * @type {number|null}
  210. */
  211. this.deferredStartP2PTask = null;
  212. const delay
  213. = parseInt(options.config.p2p && options.config.p2p.backToP2PDelay, 10);
  214. /**
  215. * A delay given in seconds, before the conference switches back to P2P
  216. * after the 3rd participant has left.
  217. * @type {number}
  218. */
  219. this.backToP2PDelay = isNaN(delay) ? 5 : delay;
  220. logger.info(`backToP2PDelay: ${this.backToP2PDelay}`);
  221. /**
  222. * If set to <tt>true</tt> it means the P2P ICE is no longer connected.
  223. * When <tt>false</tt> it means that P2P ICE (media) connection is up
  224. * and running.
  225. * @type {boolean}
  226. */
  227. this.isP2PConnectionInterrupted = false;
  228. /**
  229. * Flag set to <tt>true</tt> when P2P session has been established
  230. * (ICE has been connected) and this conference is currently in the peer to
  231. * peer mode (P2P connection is the active one).
  232. * @type {boolean}
  233. */
  234. this.p2p = false;
  235. /**
  236. * A JingleSession for the direct peer to peer connection.
  237. * @type {JingleSessionPC}
  238. */
  239. this.p2pJingleSession = null;
  240. this.videoSIPGWHandler = new VideoSIPGW(this.room);
  241. this.recordingManager = new RecordingManager(this.room);
  242. /**
  243. * If the conference.joined event has been sent this will store the timestamp when it happened.
  244. *
  245. * @type {undefined|number}
  246. * @private
  247. */
  248. this._conferenceJoinAnalyticsEventSent = undefined;
  249. /**
  250. * End-to-End Encryption. Make it available if supported.
  251. */
  252. if (this.isE2EESupported()) {
  253. logger.info('End-to-End Encryption is supported');
  254. this._e2eEncryption = new E2EEncryption(this);
  255. }
  256. /**
  257. * Flag set to <tt>true</tt> when Jicofo sends a presence message indicating that the max audio sender limit has
  258. * been reached for the call. Once this is set, unmuting audio will be disabled from the client until it gets reset
  259. * again by Jicofo.
  260. */
  261. this._audioSenderLimitReached = undefined;
  262. /**
  263. * Flag set to <tt>true</tt> when Jicofo sends a presence message indicating that the max video sender limit has
  264. * been reached for the call. Once this is set, unmuting video will be disabled from the client until it gets reset
  265. * again by Jicofo.
  266. */
  267. this._videoSenderLimitReached = undefined;
  268. }
  269. // FIXME convert JitsiConference to ES6 - ASAP !
  270. JitsiConference.prototype.constructor = JitsiConference;
  271. /**
  272. * Create a resource for the a jid. We use the room nickname (the resource part
  273. * of the occupant JID, see XEP-0045) as the endpoint ID in colibri. We require
  274. * endpoint IDs to be 8 hex digits because in some cases they get serialized
  275. * into a 32bit field.
  276. *
  277. * @param {string} jid - The id set onto the XMPP connection.
  278. * @param {boolean} isAuthenticatedUser - Whether or not the user has connected
  279. * to the XMPP service with a password.
  280. * @returns {string}
  281. * @static
  282. */
  283. JitsiConference.resourceCreator = function(jid, isAuthenticatedUser) {
  284. let mucNickname;
  285. if (isAuthenticatedUser) {
  286. // For authenticated users generate a random ID.
  287. mucNickname = RandomUtil.randomHexString(8).toLowerCase();
  288. } else {
  289. // We try to use the first part of the node (which for anonymous users
  290. // on prosody is a UUID) to match the previous behavior (and maybe make
  291. // debugging easier).
  292. mucNickname = Strophe.getNodeFromJid(jid)?.substr(0, 8)
  293. .toLowerCase();
  294. // But if this doesn't have the required format we just generate a new
  295. // random nickname.
  296. const re = /[0-9a-f]{8}/g;
  297. if (!mucNickname || !re.test(mucNickname)) {
  298. mucNickname = RandomUtil.randomHexString(8).toLowerCase();
  299. }
  300. }
  301. return mucNickname;
  302. };
  303. /**
  304. * Initializes the conference object properties
  305. * @param options {object}
  306. * @param options.connection {JitsiConnection} overrides this.connection
  307. */
  308. JitsiConference.prototype._init = function(options = {}) {
  309. this.eventManager.setupXMPPListeners();
  310. const { config } = this.options;
  311. // Get the codec preference settings from config.js.
  312. // 'preferH264' and 'disableH264' settings have been deprecated for a while,
  313. // 'preferredCodec' and 'disabledCodec' will have precedence over them.
  314. const codecSettings = {
  315. disabledCodec: config.videoQuality
  316. ? config.videoQuality.disabledCodec
  317. : config.p2p && config.p2p.disableH264 && CodecMimeType.H264,
  318. enforcePreferredCodec: config.videoQuality && config.videoQuality.enforcePreferredCodec,
  319. jvbCodec: (config.videoQuality && config.videoQuality.preferredCodec)
  320. || (config.preferH264 && CodecMimeType.H264),
  321. p2pCodec: config.p2p
  322. ? config.p2p.preferredCodec || (config.p2p.preferH264 && CodecMimeType.H264)
  323. : CodecMimeType.VP8
  324. };
  325. this.codecSelection = new CodecSelection(this, codecSettings);
  326. this._statsCurrentId = config.statisticsId ? config.statisticsId : Settings.callStatsUserName;
  327. this.room = this.xmpp.createRoom(
  328. this.options.name, {
  329. ...config,
  330. statsId: this._statsCurrentId
  331. },
  332. JitsiConference.resourceCreator
  333. );
  334. this._signalingLayer.setChatRoom(this.room);
  335. // Connection interrupted/restored listeners
  336. this._onIceConnectionInterrupted
  337. = this._onIceConnectionInterrupted.bind(this);
  338. this.room.addListener(
  339. XMPPEvents.CONNECTION_INTERRUPTED, this._onIceConnectionInterrupted);
  340. this._onIceConnectionRestored = this._onIceConnectionRestored.bind(this);
  341. this.room.addListener(
  342. XMPPEvents.CONNECTION_RESTORED, this._onIceConnectionRestored);
  343. this._onIceConnectionEstablished
  344. = this._onIceConnectionEstablished.bind(this);
  345. this.room.addListener(
  346. XMPPEvents.CONNECTION_ESTABLISHED, this._onIceConnectionEstablished);
  347. this._updateProperties = this._updateProperties.bind(this);
  348. this.room.addListener(XMPPEvents.CONFERENCE_PROPERTIES_CHANGED,
  349. this._updateProperties);
  350. this._sendConferenceJoinAnalyticsEvent = this._sendConferenceJoinAnalyticsEvent.bind(this);
  351. this.room.addListener(XMPPEvents.MEETING_ID_SET, this._sendConferenceJoinAnalyticsEvent);
  352. this._removeLocalSourceOnReject = this._removeLocalSourceOnReject.bind(this);
  353. this._updateRoomPresence = this._updateRoomPresence.bind(this);
  354. this.room.addListener(XMPPEvents.SESSION_ACCEPT, this._updateRoomPresence);
  355. this.room.addListener(XMPPEvents.SOURCE_ADD, this._updateRoomPresence);
  356. this.room.addListener(XMPPEvents.SOURCE_ADD_ERROR, this._removeLocalSourceOnReject);
  357. this.room.addListener(XMPPEvents.SOURCE_REMOVE, this._updateRoomPresence);
  358. if (config.e2eping?.enabled) {
  359. this.e2eping = new E2ePing(
  360. this,
  361. config,
  362. (message, to) => {
  363. try {
  364. this.sendMessage(message, to, true /* sendThroughVideobridge */);
  365. } catch (error) {
  366. logger.warn('Failed to send E2E ping request or response.', error && error.msg);
  367. }
  368. });
  369. }
  370. if (!this.rtc) {
  371. this.rtc = new RTC(this, options);
  372. this.eventManager.setupRTCListeners();
  373. if (FeatureFlags.isSourceNameSignalingEnabled()) {
  374. this._registerRtcListeners(this.rtc);
  375. }
  376. }
  377. this.receiveVideoController = new ReceiveVideoController(this, this.rtc);
  378. this.sendVideoController = new SendVideoController(this, this.rtc);
  379. // Do not initialize ParticipantConnectionStatusHandler when source-name signaling is enabled.
  380. if (!FeatureFlags.isSourceNameSignalingEnabled()) {
  381. this.participantConnectionStatus
  382. = new ParticipantConnectionStatusHandler(
  383. this.rtc,
  384. this,
  385. {
  386. // These options are not public API, leaving it here only as an entry point through config for tuning
  387. // up purposes. Default values should be adjusted as soon as optimal values are discovered.
  388. p2pRtcMuteTimeout: config._p2pConnStatusRtcMuteTimeout,
  389. rtcMuteTimeout: config._peerConnStatusRtcMuteTimeout,
  390. outOfLastNTimeout: config._peerConnStatusOutOfLastNTimeout
  391. });
  392. this.participantConnectionStatus.init();
  393. }
  394. // Add the ability to enable callStats only on a percentage of users based on config.js settings.
  395. let enableCallStats = true;
  396. if (config.testing && config.testing.callStatsThreshold) {
  397. enableCallStats = (Math.random() * 100) <= config.testing.callStatsThreshold;
  398. }
  399. if (!this.statistics) {
  400. this.statistics = new Statistics(this.xmpp, {
  401. aliasName: this._statsCurrentId,
  402. userName: config.statisticsDisplayName ? config.statisticsDisplayName : this.myUserId(),
  403. confID: config.confID || `${this.connection.options.hosts.domain}/${this.options.name}`,
  404. siteID: config.siteID,
  405. customScriptUrl: config.callStatsCustomScriptUrl,
  406. callStatsID: config.callStatsID,
  407. callStatsSecret: config.callStatsSecret,
  408. callStatsApplicationLogsDisabled: config.callStatsApplicationLogsDisabled,
  409. enableCallStats,
  410. roomName: this.options.name,
  411. applicationName: config.applicationName,
  412. getWiFiStatsMethod: config.getWiFiStatsMethod,
  413. configParams: config.callStatsConfigParams
  414. });
  415. Statistics.analytics.addPermanentProperties({
  416. 'callstats_name': this._statsCurrentId
  417. });
  418. // Start performance observer for monitoring long tasks
  419. if (config.longTasksStatsInterval) {
  420. this.statistics.attachLongTasksStats(this);
  421. }
  422. }
  423. this.eventManager.setupChatRoomListeners();
  424. // Always add listeners because on reload we are executing leave and the
  425. // listeners are removed from statistics module.
  426. this.eventManager.setupStatisticsListeners();
  427. // Disable VAD processing on Safari since it causes audio input to
  428. // fail on some of the mobile devices.
  429. if (config.enableTalkWhileMuted && browser.supportsVADDetection()) {
  430. // If VAD processor factory method is provided uses VAD based detection, otherwise fallback to audio level
  431. // based detection.
  432. if (config.createVADProcessor) {
  433. logger.info('Using VAD detection for generating talk while muted events');
  434. if (!this._audioAnalyser) {
  435. this._audioAnalyser = new VADAudioAnalyser(this, config.createVADProcessor);
  436. }
  437. const vadTalkMutedDetection = new VADTalkMutedDetection();
  438. vadTalkMutedDetection.on(DetectionEvents.VAD_TALK_WHILE_MUTED, () =>
  439. this.eventEmitter.emit(JitsiConferenceEvents.TALK_WHILE_MUTED));
  440. this._audioAnalyser.addVADDetectionService(vadTalkMutedDetection);
  441. } else {
  442. logger.warn('No VAD Processor was provided. Talk while muted detection service was not initialized!');
  443. }
  444. }
  445. // Disable noisy mic detection on safari since it causes the audio input to
  446. // fail on Safari on iPadOS.
  447. if (config.enableNoisyMicDetection && browser.supportsVADDetection()) {
  448. if (config.createVADProcessor) {
  449. if (!this._audioAnalyser) {
  450. this._audioAnalyser = new VADAudioAnalyser(this, config.createVADProcessor);
  451. }
  452. const vadNoiseDetection = new VADNoiseDetection();
  453. vadNoiseDetection.on(DetectionEvents.VAD_NOISY_DEVICE, () =>
  454. this.eventEmitter.emit(JitsiConferenceEvents.NOISY_MIC));
  455. this._audioAnalyser.addVADDetectionService(vadNoiseDetection);
  456. } else {
  457. logger.warn('No VAD Processor was provided. Noisy microphone detection service was not initialized!');
  458. }
  459. }
  460. // Generates events based on no audio input detector.
  461. if (config.enableNoAudioDetection) {
  462. this._noAudioSignalDetection = new NoAudioSignalDetection(this);
  463. this._noAudioSignalDetection.on(DetectionEvents.NO_AUDIO_INPUT, () => {
  464. this.eventEmitter.emit(JitsiConferenceEvents.NO_AUDIO_INPUT);
  465. });
  466. this._noAudioSignalDetection.on(DetectionEvents.AUDIO_INPUT_STATE_CHANGE, hasAudioSignal => {
  467. this.eventEmitter.emit(JitsiConferenceEvents.AUDIO_INPUT_STATE_CHANGE, hasAudioSignal);
  468. });
  469. }
  470. if ('channelLastN' in config) {
  471. this.setLastN(config.channelLastN);
  472. }
  473. /**
  474. * Emits {@link JitsiConferenceEvents.JVB121_STATUS}.
  475. * @type {Jvb121EventGenerator}
  476. */
  477. this.jvb121Status = new Jvb121EventGenerator(this);
  478. // creates dominant speaker detection that works only in p2p mode
  479. this.p2pDominantSpeakerDetection = new P2PDominantSpeakerDetection(this);
  480. if (config && config.deploymentInfo && config.deploymentInfo.userRegion) {
  481. this.setLocalParticipantProperty(
  482. 'region', config.deploymentInfo.userRegion);
  483. }
  484. // Publish the codec type to presence.
  485. this.setLocalParticipantProperty('codecType', this.codecSelection.getPreferredCodec());
  486. // Set transcription language presence extension.
  487. // In case the language config is undefined or has the default value that the transcriber uses
  488. // (in our case Jigasi uses 'en-US'), don't set the participant property in order to avoid
  489. // needlessly polluting the presence stanza.
  490. if (config && config.transcriptionLanguage && config.transcriptionLanguage !== 'en-US') {
  491. this.setLocalParticipantProperty('transcription_language', config.transcriptionLanguage);
  492. }
  493. };
  494. /**
  495. * Joins the conference.
  496. * @param password {string} the password
  497. * @param replaceParticipant {boolean} whether the current join replaces
  498. * an existing participant with same jwt from the meeting.
  499. */
  500. JitsiConference.prototype.join = function(password, replaceParticipant = false) {
  501. if (this.room) {
  502. this.room.join(password, replaceParticipant).then(() => this._maybeSetSITimeout());
  503. }
  504. };
  505. /**
  506. * Authenticates and upgrades the role of the local participant/user.
  507. *
  508. * @returns {Object} A <tt>thenable</tt> which (1) settles when the process of
  509. * authenticating and upgrading the role of the local participant/user finishes
  510. * and (2) has a <tt>cancel</tt> method that allows the caller to interrupt the
  511. * process.
  512. */
  513. JitsiConference.prototype.authenticateAndUpgradeRole = function(options) {
  514. return authenticateAndUpgradeRole.call(this, {
  515. ...options,
  516. onCreateResource: JitsiConference.resourceCreator
  517. });
  518. };
  519. /**
  520. * Check if joined to the conference.
  521. */
  522. JitsiConference.prototype.isJoined = function() {
  523. return this.room && this.room.joined;
  524. };
  525. /**
  526. * Tells whether or not the P2P mode is enabled in the configuration.
  527. * @return {boolean}
  528. */
  529. JitsiConference.prototype.isP2PEnabled = function() {
  530. return Boolean(this.options.config.p2p && this.options.config.p2p.enabled)
  531. // FIXME: remove once we have a default config template. -saghul
  532. || typeof this.options.config.p2p === 'undefined';
  533. };
  534. /**
  535. * When in P2P test mode, the conference will not automatically switch to P2P
  536. * when there 2 participants.
  537. * @return {boolean}
  538. */
  539. JitsiConference.prototype.isP2PTestModeEnabled = function() {
  540. return Boolean(this.options.config.testing
  541. && this.options.config.testing.p2pTestMode);
  542. };
  543. /**
  544. * Leaves the conference.
  545. * @param reason {string|undefined} The reason for leaving the conference.
  546. * @returns {Promise}
  547. */
  548. JitsiConference.prototype.leave = async function(reason) {
  549. if (this.participantConnectionStatus) {
  550. this.participantConnectionStatus.dispose();
  551. this.participantConnectionStatus = null;
  552. }
  553. if (this.avgRtpStatsReporter) {
  554. this.avgRtpStatsReporter.dispose();
  555. this.avgRtpStatsReporter = null;
  556. }
  557. if (this._audioOutputProblemDetector) {
  558. this._audioOutputProblemDetector.dispose();
  559. this._audioOutputProblemDetector = null;
  560. }
  561. if (this.e2eping) {
  562. this.e2eping.stop();
  563. this.e2eping = null;
  564. }
  565. this.getLocalTracks().forEach(track => this.onLocalTrackRemoved(track));
  566. this.rtc.closeBridgeChannel();
  567. this._sendConferenceLeftAnalyticsEvent();
  568. if (this.statistics) {
  569. this.statistics.dispose();
  570. }
  571. this._delayedIceFailed && this._delayedIceFailed.cancel();
  572. this._maybeClearSITimeout();
  573. // Close both JVb and P2P JingleSessions
  574. if (this.jvbJingleSession) {
  575. this.jvbJingleSession.close();
  576. this.jvbJingleSession = null;
  577. }
  578. if (this.p2pJingleSession) {
  579. this.p2pJingleSession.close();
  580. this.p2pJingleSession = null;
  581. }
  582. // Leave the conference. If this.room == null we are calling second time leave().
  583. if (!this.room) {
  584. throw new Error('You have already left the conference');
  585. }
  586. const room = this.room;
  587. // Unregister connection state listeners
  588. room.removeListener(
  589. XMPPEvents.CONNECTION_INTERRUPTED,
  590. this._onIceConnectionInterrupted);
  591. room.removeListener(
  592. XMPPEvents.CONNECTION_RESTORED,
  593. this._onIceConnectionRestored);
  594. room.removeListener(
  595. XMPPEvents.CONNECTION_ESTABLISHED,
  596. this._onIceConnectionEstablished);
  597. room.removeListener(
  598. XMPPEvents.CONFERENCE_PROPERTIES_CHANGED,
  599. this._updateProperties);
  600. room.removeListener(XMPPEvents.MEETING_ID_SET, this._sendConferenceJoinAnalyticsEvent);
  601. room.removeListener(XMPPEvents.SESSION_ACCEPT, this._updateRoomPresence);
  602. room.removeListener(XMPPEvents.SOURCE_ADD, this._updateRoomPresence);
  603. room.removeListener(XMPPEvents.SOURCE_ADD_ERROR, this._removeLocalSourceOnReject);
  604. room.removeListener(XMPPEvents.SOURCE_REMOVE, this._updateRoomPresence);
  605. this.eventManager.removeXMPPListeners();
  606. this._signalingLayer.setChatRoom(null);
  607. this.room = null;
  608. let leaveError;
  609. try {
  610. await room.leave(reason);
  611. } catch (err) {
  612. leaveError = err;
  613. // Remove all participants because currently the conference
  614. // won't be usable anyway. This is done on success automatically
  615. // by the ChatRoom instance.
  616. this.getParticipants().forEach(
  617. participant => this.onMemberLeft(participant.getJid()));
  618. }
  619. if (this.rtc) {
  620. this.rtc.destroy();
  621. }
  622. if (leaveError) {
  623. throw leaveError;
  624. }
  625. };
  626. /**
  627. * Returns <tt>true</tt> if end conference support is enabled in the backend.
  628. *
  629. * @returns {boolean} whether end conference is supported in the backend.
  630. */
  631. JitsiConference.prototype.isEndConferenceSupported = function() {
  632. return Boolean(this.room && this.room.xmpp.endConferenceComponentAddress);
  633. };
  634. /**
  635. * Ends the conference.
  636. */
  637. JitsiConference.prototype.end = function() {
  638. if (!this.isEndConferenceSupported()) {
  639. logger.warn('Cannot end conference: is not supported.');
  640. return;
  641. }
  642. if (!this.room) {
  643. throw new Error('The conference has been already left');
  644. }
  645. this.room.end();
  646. };
  647. /**
  648. * Returns the currently active media session if any.
  649. *
  650. * @returns {JingleSessionPC|undefined}
  651. */
  652. JitsiConference.prototype.getActiveMediaSession = function() {
  653. return this.isP2PActive() ? this.p2pJingleSession : this.jvbJingleSession;
  654. };
  655. /**
  656. * Returns an array containing all media sessions existing in this conference.
  657. *
  658. * @returns {Array<JingleSessionPC>}
  659. */
  660. JitsiConference.prototype.getMediaSessions = function() {
  661. const sessions = [];
  662. this.jvbJingleSession && sessions.push(this.jvbJingleSession);
  663. this.p2pJingleSession && sessions.push(this.p2pJingleSession);
  664. return sessions;
  665. };
  666. /**
  667. * Registers event listeners on the RTC instance.
  668. * @param {RTC} rtc - the RTC module instance used by this conference.
  669. * @private
  670. * @returns {void}
  671. */
  672. JitsiConference.prototype._registerRtcListeners = function(rtc) {
  673. rtc.addListener(RTCEvents.DATA_CHANNEL_OPEN, () => {
  674. for (const localTrack of this.rtc.localTracks) {
  675. localTrack.isVideoTrack() && this._sendBridgeVideoTypeMessage(localTrack);
  676. }
  677. });
  678. };
  679. /**
  680. * Sends the 'VideoTypeMessage' to the bridge on the bridge channel so that the bridge can make bitrate allocation
  681. * decisions based on the video type of the local source.
  682. *
  683. * @param {JitsiLocalTrack} localtrack - The track associated with the local source signaled to the bridge.
  684. * @returns {void}
  685. * @private
  686. */
  687. JitsiConference.prototype._sendBridgeVideoTypeMessage = function(localtrack) {
  688. let videoType = !localtrack || localtrack.isMuted() ? BridgeVideoType.NONE : localtrack.getVideoType();
  689. if (videoType === BridgeVideoType.DESKTOP && this._desktopSharingFrameRate > SS_DEFAULT_FRAME_RATE) {
  690. videoType = BridgeVideoType.DESKTOP_HIGH_FPS;
  691. }
  692. if (FeatureFlags.isSourceNameSignalingEnabled() && localtrack) {
  693. this.rtc.sendSourceVideoType(localtrack.getSourceName(), videoType);
  694. } else if (!FeatureFlags.isSourceNameSignalingEnabled()) {
  695. this.rtc.setVideoType(videoType);
  696. }
  697. };
  698. /**
  699. * Returns name of this conference.
  700. */
  701. JitsiConference.prototype.getName = function() {
  702. return this.options.name.toString();
  703. };
  704. /**
  705. * Returns the {@link JitsiConnection} used by this this conference.
  706. */
  707. JitsiConference.prototype.getConnection = function() {
  708. return this.connection;
  709. };
  710. /**
  711. * Check if authentication is enabled for this conference.
  712. */
  713. JitsiConference.prototype.isAuthEnabled = function() {
  714. return this.authEnabled;
  715. };
  716. /**
  717. * Check if user is logged in.
  718. */
  719. JitsiConference.prototype.isLoggedIn = function() {
  720. return Boolean(this.authIdentity);
  721. };
  722. /**
  723. * Get authorized login.
  724. */
  725. JitsiConference.prototype.getAuthLogin = function() {
  726. return this.authIdentity;
  727. };
  728. /**
  729. * Check if external authentication is enabled for this conference.
  730. */
  731. JitsiConference.prototype.isExternalAuthEnabled = function() {
  732. return this.room && this.room.moderator.isExternalAuthEnabled();
  733. };
  734. /**
  735. * Get url for external authentication.
  736. * @param {boolean} [urlForPopup] if true then return url for login popup,
  737. * else url of login page.
  738. * @returns {Promise}
  739. */
  740. JitsiConference.prototype.getExternalAuthUrl = function(urlForPopup) {
  741. return new Promise((resolve, reject) => {
  742. if (!this.isExternalAuthEnabled()) {
  743. reject();
  744. return;
  745. }
  746. if (urlForPopup) {
  747. this.room.moderator.getPopupLoginUrl(resolve, reject);
  748. } else {
  749. this.room.moderator.getLoginUrl(resolve, reject);
  750. }
  751. });
  752. };
  753. /**
  754. * Returns the local tracks of the given media type, or all local tracks if no
  755. * specific type is given.
  756. * @param {MediaType} [mediaType] Optional media type (audio or video).
  757. */
  758. JitsiConference.prototype.getLocalTracks = function(mediaType) {
  759. let tracks = [];
  760. if (this.rtc) {
  761. tracks = this.rtc.getLocalTracks(mediaType);
  762. }
  763. return tracks;
  764. };
  765. /**
  766. * Obtains local audio track.
  767. * @return {JitsiLocalTrack|null}
  768. */
  769. JitsiConference.prototype.getLocalAudioTrack = function() {
  770. return this.rtc ? this.rtc.getLocalAudioTrack() : null;
  771. };
  772. /**
  773. * Obtains local video track.
  774. * @return {JitsiLocalTrack|null}
  775. */
  776. JitsiConference.prototype.getLocalVideoTrack = function() {
  777. return this.rtc ? this.rtc.getLocalVideoTrack() : null;
  778. };
  779. /**
  780. * Returns all the local video tracks.
  781. * @returns {Array<JitsiLocalTrack>}
  782. */
  783. JitsiConference.prototype.getLocalVideoTracks = function() {
  784. return this.rtc ? this.rtc.getLocalVideoTracks() : null;
  785. };
  786. /**
  787. * Obtains the performance statistics.
  788. * @returns {Object|null}
  789. */
  790. JitsiConference.prototype.getPerformanceStats = function() {
  791. return {
  792. longTasksStats: this.statistics.getLongTasksStats()
  793. };
  794. };
  795. /**
  796. * Attaches a handler for events(For example - "participant joined".) in the
  797. * conference. All possible event are defined in JitsiConferenceEvents.
  798. * @param eventId the event ID.
  799. * @param handler handler for the event.
  800. *
  801. * Note: consider adding eventing functionality by extending an EventEmitter
  802. * impl, instead of rolling ourselves
  803. */
  804. JitsiConference.prototype.on = function(eventId, handler) {
  805. if (this.eventEmitter) {
  806. this.eventEmitter.on(eventId, handler);
  807. }
  808. };
  809. /**
  810. * Removes event listener
  811. * @param eventId the event ID.
  812. * @param [handler] optional, the specific handler to unbind
  813. *
  814. * Note: consider adding eventing functionality by extending an EventEmitter
  815. * impl, instead of rolling ourselves
  816. */
  817. JitsiConference.prototype.off = function(eventId, handler) {
  818. if (this.eventEmitter) {
  819. this.eventEmitter.removeListener(eventId, handler);
  820. }
  821. };
  822. // Common aliases for event emitter
  823. JitsiConference.prototype.addEventListener = JitsiConference.prototype.on;
  824. JitsiConference.prototype.removeEventListener = JitsiConference.prototype.off;
  825. /**
  826. * Receives notifications from other participants about commands / custom events
  827. * (sent by sendCommand or sendCommandOnce methods).
  828. * @param command {String} the name of the command
  829. * @param handler {Function} handler for the command
  830. */
  831. JitsiConference.prototype.addCommandListener = function(command, handler) {
  832. if (this.room) {
  833. this.room.addPresenceListener(command, handler);
  834. }
  835. };
  836. /**
  837. * Removes command listener
  838. * @param command {String} the name of the command
  839. * @param handler {Function} handler to remove for the command
  840. */
  841. JitsiConference.prototype.removeCommandListener = function(command, handler) {
  842. if (this.room) {
  843. this.room.removePresenceListener(command, handler);
  844. }
  845. };
  846. /**
  847. * Sends text message to the other participants in the conference
  848. * @param message the text message.
  849. * @param elementName the element name to encapsulate the message.
  850. * @deprecated Use 'sendMessage' instead. TODO: this should be private.
  851. */
  852. JitsiConference.prototype.sendTextMessage = function(message, elementName = 'body') {
  853. if (this.room) {
  854. this.room.sendMessage(message, elementName);
  855. }
  856. };
  857. /**
  858. * Send private text message to another participant of the conference
  859. * @param id the id of the participant to send a private message.
  860. * @param message the text message.
  861. * @param elementName the element name to encapsulate the message.
  862. * @deprecated Use 'sendMessage' instead. TODO: this should be private.
  863. */
  864. JitsiConference.prototype.sendPrivateTextMessage = function(id, message, elementName = 'body') {
  865. if (this.room) {
  866. this.room.sendPrivateMessage(id, message, elementName);
  867. }
  868. };
  869. /**
  870. * Send presence command.
  871. * @param name {String} the name of the command.
  872. * @param values {Object} with keys and values that will be sent.
  873. **/
  874. JitsiConference.prototype.sendCommand = function(name, values) {
  875. if (this.room) {
  876. this.room.addOrReplaceInPresence(name, values) && this.room.sendPresence();
  877. } else {
  878. logger.warn('Not sending a command, room not initialized.');
  879. }
  880. };
  881. /**
  882. * Send presence command one time.
  883. * @param name {String} the name of the command.
  884. * @param values {Object} with keys and values that will be sent.
  885. **/
  886. JitsiConference.prototype.sendCommandOnce = function(name, values) {
  887. this.sendCommand(name, values);
  888. this.removeCommand(name);
  889. };
  890. /**
  891. * Removes presence command.
  892. * @param name {String} the name of the command.
  893. **/
  894. JitsiConference.prototype.removeCommand = function(name) {
  895. if (this.room) {
  896. this.room.removeFromPresence(name);
  897. }
  898. };
  899. /**
  900. * Sets the display name for this conference.
  901. * @param name the display name to set
  902. */
  903. JitsiConference.prototype.setDisplayName = function(name) {
  904. if (this.room) {
  905. const nickKey = 'nick';
  906. // if there is no display name already set, avoid setting an empty one
  907. if (!name && !this.room.getFromPresence(nickKey)) {
  908. return;
  909. }
  910. this.room.addOrReplaceInPresence(nickKey, {
  911. attributes: { xmlns: 'http://jabber.org/protocol/nick' },
  912. value: name
  913. }) && this.room.sendPresence();
  914. }
  915. };
  916. /**
  917. * Set new subject for this conference. (available only for moderator)
  918. * @param {string} subject new subject
  919. */
  920. JitsiConference.prototype.setSubject = function(subject) {
  921. if (this.room && this.isModerator()) {
  922. this.room.setSubject(subject);
  923. } else {
  924. logger.warn(`Failed to set subject, ${this.room ? '' : 'not in a room, '}${
  925. this.isModerator() ? '' : 'participant is not a moderator'}`);
  926. }
  927. };
  928. /**
  929. * Get a transcriber object for all current participants in this conference
  930. * @return {Transcriber} the transcriber object
  931. */
  932. JitsiConference.prototype.getTranscriber = function() {
  933. if (this.transcriber === undefined) {
  934. this.transcriber = new Transcriber();
  935. // add all existing local audio tracks to the transcriber
  936. const localAudioTracks = this.getLocalTracks(MediaType.AUDIO);
  937. for (const localAudio of localAudioTracks) {
  938. this.transcriber.addTrack(localAudio);
  939. }
  940. // and all remote audio tracks
  941. const remoteAudioTracks = this.rtc.getRemoteTracks(MediaType.AUDIO);
  942. for (const remoteTrack of remoteAudioTracks) {
  943. this.transcriber.addTrack(remoteTrack);
  944. }
  945. }
  946. return this.transcriber;
  947. };
  948. /**
  949. * Returns the transcription status.
  950. *
  951. * @returns {String} "on" or "off".
  952. */
  953. JitsiConference.prototype.getTranscriptionStatus = function() {
  954. return this.room.transcriptionStatus;
  955. };
  956. /**
  957. * Adds JitsiLocalTrack object to the conference.
  958. * @param {JitsiLocalTrack} track the JitsiLocalTrack object.
  959. * @returns {Promise<JitsiLocalTrack>}
  960. * @throws {Error} if the specified track is a video track and there is already
  961. * another video track in the conference.
  962. */
  963. JitsiConference.prototype.addTrack = function(track) {
  964. const mediaType = track.getType();
  965. const localTracks = this.rtc.getLocalTracks(mediaType);
  966. // Ensure there's exactly 1 local track of each media type in the conference.
  967. if (localTracks.length > 0) {
  968. // Don't be excessively harsh and severe if the API client happens to attempt to add the same local track twice.
  969. if (track === localTracks[0]) {
  970. return Promise.resolve(track);
  971. }
  972. if (FeatureFlags.isMultiStreamSupportEnabled() && mediaType === MediaType.VIDEO) {
  973. const sourceName = getSourceNameForJitsiTrack(
  974. this.myUserId(),
  975. mediaType,
  976. this.getLocalTracks(mediaType)?.length);
  977. track.setSourceName(sourceName);
  978. const addTrackPromises = [];
  979. this.p2pJingleSession && addTrackPromises.push(this.p2pJingleSession.addTracks([ track ]));
  980. this.jvbJingleSession && addTrackPromises.push(this.jvbJingleSession.addTracks([ track ]));
  981. return Promise.all(addTrackPromises)
  982. .then(() => {
  983. this._setupNewTrack(track);
  984. this._sendBridgeVideoTypeMessage(track);
  985. this._updateRoomPresence(this.getActiveMediaSession());
  986. if (this.isMutedByFocus || this.isVideoMutedByFocus) {
  987. this._fireMuteChangeEvent(track);
  988. }
  989. });
  990. }
  991. return Promise.reject(new Error(`Cannot add second ${mediaType} track to the conference`));
  992. }
  993. return this.replaceTrack(null, track)
  994. .then(() => {
  995. // Presence needs to be sent here for desktop track since we need the presence to reach the remote peer
  996. // before signaling so that a fake participant tile is created for screenshare. Otherwise, presence will
  997. // only be sent after a session-accept or source-add is ack'ed.
  998. if (track.getVideoType() === VideoType.DESKTOP && FeatureFlags.isMultiStreamSupportEnabled()) {
  999. this._updateRoomPresence(this.getActiveMediaSession());
  1000. }
  1001. });
  1002. };
  1003. /**
  1004. * Fires TRACK_AUDIO_LEVEL_CHANGED change conference event (for local tracks).
  1005. * @param {number} audioLevel the audio level
  1006. * @param {TraceablePeerConnection} [tpc]
  1007. */
  1008. JitsiConference.prototype._fireAudioLevelChangeEvent = function(audioLevel, tpc) {
  1009. const activeTpc = this.getActivePeerConnection();
  1010. // There will be no TraceablePeerConnection if audio levels do not come from
  1011. // a peerconnection. LocalStatsCollector.js measures audio levels using Web
  1012. // Audio Analyser API and emits local audio levels events through
  1013. // JitsiTrack.setAudioLevel, but does not provide TPC instance which is
  1014. // optional.
  1015. if (!tpc || activeTpc === tpc) {
  1016. this.eventEmitter.emit(
  1017. JitsiConferenceEvents.TRACK_AUDIO_LEVEL_CHANGED,
  1018. this.myUserId(), audioLevel);
  1019. }
  1020. };
  1021. /**
  1022. * Fires TRACK_MUTE_CHANGED change conference event.
  1023. * @param track the JitsiTrack object related to the event.
  1024. */
  1025. JitsiConference.prototype._fireMuteChangeEvent = function(track) {
  1026. // check if track was muted by focus and now is unmuted by user
  1027. if (this.isMutedByFocus && track.isAudioTrack() && !track.isMuted()) {
  1028. this.isMutedByFocus = false;
  1029. // unmute local user on server
  1030. this.room.muteParticipant(this.room.myroomjid, false, MediaType.AUDIO);
  1031. } else if (this.isVideoMutedByFocus && track.isVideoTrack() && !track.isMuted()) {
  1032. this.isVideoMutedByFocus = false;
  1033. // unmute local user on server
  1034. this.room.muteParticipant(this.room.myroomjid, false, MediaType.VIDEO);
  1035. }
  1036. let actorParticipant;
  1037. if (this.mutedByFocusActor && track.isAudioTrack()) {
  1038. const actorId = Strophe.getResourceFromJid(this.mutedByFocusActor);
  1039. actorParticipant = this.participants[actorId];
  1040. } else if (this.mutedVideoByFocusActor && track.isVideoTrack()) {
  1041. const actorId = Strophe.getResourceFromJid(this.mutedVideoByFocusActor);
  1042. actorParticipant = this.participants[actorId];
  1043. }
  1044. // Send the video type message to the bridge if the track is not removed/added to the pc as part of
  1045. // the mute/unmute operation. This currently happens only on Firefox.
  1046. if (track.isVideoTrack() && !browser.doesVideoMuteByStreamRemove()) {
  1047. this._sendBridgeVideoTypeMessage(track);
  1048. }
  1049. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_MUTE_CHANGED, track, actorParticipant);
  1050. };
  1051. /**
  1052. * Returns the list of local tracks that need to be added to the peerconnection on join.
  1053. * This takes the startAudioMuted/startVideoMuted flags into consideration since we do not
  1054. * want to add the tracks if the user joins the call audio/video muted. The tracks will be
  1055. * added when the user unmutes for the first time.
  1056. * @returns {Array<JitsiLocalTrack>} - list of local tracks that are unmuted.
  1057. */
  1058. JitsiConference.prototype._getInitialLocalTracks = function() {
  1059. // Always add the audio track on certain platforms:
  1060. // * Safari / WebKit: because of a known issue where audio playout doesn't happen
  1061. // if the user joins audio and video muted.
  1062. // * React Native: after iOS 15, if a user joins muted they won't be able to unmute.
  1063. return this.getLocalTracks()
  1064. .filter(track => {
  1065. const trackType = track.getType();
  1066. if (trackType === MediaType.AUDIO
  1067. && (!this.isStartAudioMuted() || browser.isWebKitBased() || browser.isReactNative())) {
  1068. return true;
  1069. } else if (trackType === MediaType.VIDEO && !this.isStartVideoMuted()) {
  1070. return true;
  1071. }
  1072. return false;
  1073. });
  1074. };
  1075. /**
  1076. * Clear JitsiLocalTrack properties and listeners.
  1077. * @param track the JitsiLocalTrack object.
  1078. */
  1079. JitsiConference.prototype.onLocalTrackRemoved = function(track) {
  1080. track.setConference(null);
  1081. this.rtc.removeLocalTrack(track);
  1082. track.removeEventListener(JitsiTrackEvents.TRACK_MUTE_CHANGED, track.muteHandler);
  1083. if (track.isAudioTrack()) {
  1084. track.removeEventListener(JitsiTrackEvents.TRACK_AUDIO_LEVEL_CHANGED, track.audioLevelHandler);
  1085. }
  1086. // send event for stopping screen sharing
  1087. // FIXME: we assume we have only one screen sharing track
  1088. // if we change this we need to fix this check
  1089. if (track.isVideoTrack() && track.videoType === VideoType.DESKTOP) {
  1090. this.statistics.sendScreenSharingEvent(false);
  1091. }
  1092. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_REMOVED, track);
  1093. };
  1094. /**
  1095. * Removes JitsiLocalTrack from the conference and performs
  1096. * a new offer/answer cycle.
  1097. * @param {JitsiLocalTrack} track
  1098. * @returns {Promise}
  1099. */
  1100. JitsiConference.prototype.removeTrack = function(track) {
  1101. return this.replaceTrack(track, null);
  1102. };
  1103. /**
  1104. * Replaces oldTrack with newTrack and performs a single offer/answer
  1105. * cycle after both operations are done. Either oldTrack or newTrack
  1106. * can be null; replacing a valid 'oldTrack' with a null 'newTrack'
  1107. * effectively just removes 'oldTrack'
  1108. * @param {JitsiLocalTrack} oldTrack the current stream in use to be replaced
  1109. * @param {JitsiLocalTrack} newTrack the new stream to use
  1110. * @returns {Promise} resolves when the replacement is finished
  1111. */
  1112. JitsiConference.prototype.replaceTrack = function(oldTrack, newTrack) {
  1113. const oldVideoType = oldTrack?.getVideoType();
  1114. const mediaType = oldTrack?.getType() || newTrack?.getType();
  1115. const newVideoType = newTrack?.getVideoType();
  1116. if (FeatureFlags.isMultiStreamSupportEnabled() && oldTrack && newTrack && oldVideoType !== newVideoType) {
  1117. throw new Error(`Replacing a track of videoType=${oldVideoType} with a track of videoType=${newVideoType} is`
  1118. + ' not supported in this mode.');
  1119. }
  1120. if (FeatureFlags.isSourceNameSignalingEnabled() && newTrack) {
  1121. if (oldTrack) {
  1122. newTrack.setSourceName(oldTrack.getSourceName());
  1123. } else {
  1124. const sourceName = getSourceNameForJitsiTrack(
  1125. this.myUserId(),
  1126. mediaType,
  1127. this.getLocalTracks(mediaType)?.length);
  1128. newTrack.setSourceName(sourceName);
  1129. }
  1130. }
  1131. const oldTrackBelongsToConference = this === oldTrack?.conference;
  1132. if (oldTrackBelongsToConference && oldTrack.disposed) {
  1133. return Promise.reject(new JitsiTrackError(JitsiTrackErrors.TRACK_IS_DISPOSED));
  1134. }
  1135. if (newTrack?.disposed) {
  1136. return Promise.reject(new JitsiTrackError(JitsiTrackErrors.TRACK_IS_DISPOSED));
  1137. }
  1138. if (oldTrack && !oldTrackBelongsToConference) {
  1139. logger.warn(`JitsiConference.replaceTrack oldTrack (${oldTrack} does not belong to this conference`);
  1140. }
  1141. // Now replace the stream at the lower levels
  1142. return this._doReplaceTrack(oldTrackBelongsToConference ? oldTrack : null, newTrack)
  1143. .then(() => {
  1144. oldTrackBelongsToConference && this.onLocalTrackRemoved(oldTrack);
  1145. newTrack && this._setupNewTrack(newTrack);
  1146. // Send 'VideoTypeMessage' on the bridge channel when a video track is added/removed.
  1147. if ((oldTrackBelongsToConference && oldTrack?.isVideoTrack()) || newTrack?.isVideoTrack()) {
  1148. this._sendBridgeVideoTypeMessage(newTrack);
  1149. }
  1150. this._updateRoomPresence(this.getActiveMediaSession());
  1151. if (newTrack !== null && (this.isMutedByFocus || this.isVideoMutedByFocus)) {
  1152. this._fireMuteChangeEvent(newTrack);
  1153. }
  1154. return Promise.resolve();
  1155. })
  1156. .catch(error => {
  1157. logger.error(`replaceTrack failed: ${error?.stack}`);
  1158. return Promise.reject(error);
  1159. });
  1160. };
  1161. /**
  1162. * Replaces the tracks at the lower level by going through the Jingle session
  1163. * and WebRTC peer connection. The method will resolve immediately if there is
  1164. * currently no JingleSession started.
  1165. * @param {JitsiLocalTrack|null} oldTrack the track to be removed during
  1166. * the process or <tt>null</t> if the method should act as "add track"
  1167. * @param {JitsiLocalTrack|null} newTrack the new track to be added or
  1168. * <tt>null</tt> if the method should act as "remove track"
  1169. * @return {Promise} resolved when the process is done or rejected with a string
  1170. * which describes the error.
  1171. * @private
  1172. */
  1173. JitsiConference.prototype._doReplaceTrack = function(oldTrack, newTrack) {
  1174. const replaceTrackPromises = [];
  1175. if (this.jvbJingleSession) {
  1176. replaceTrackPromises.push(this.jvbJingleSession.replaceTrack(oldTrack, newTrack));
  1177. } else {
  1178. logger.info('_doReplaceTrack - no JVB JingleSession');
  1179. }
  1180. if (this.p2pJingleSession) {
  1181. replaceTrackPromises.push(this.p2pJingleSession.replaceTrack(oldTrack, newTrack));
  1182. } else {
  1183. logger.info('_doReplaceTrack - no P2P JingleSession');
  1184. }
  1185. return Promise.all(replaceTrackPromises);
  1186. };
  1187. /**
  1188. * Handler for when a source-add for a local source is rejected by Jicofo.
  1189. *
  1190. * @param {JingleSessionPC} jingleSession - The media session.
  1191. * @param {Error} error - The error message.
  1192. * @param {MediaType} mediaType - The media type of the track associated with the source that was rejected.
  1193. * @returns {void}
  1194. */
  1195. JitsiConference.prototype._removeLocalSourceOnReject = function(jingleSession, error, mediaType) {
  1196. if (!jingleSession) {
  1197. return;
  1198. }
  1199. logger.warn(`Source-add rejected on ${jingleSession}, reason="${error?.reason}", message="${error?.msg}"`);
  1200. const track = this.getLocalTracks(mediaType)[0];
  1201. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_UNMUTE_REJECTED, track);
  1202. };
  1203. /**
  1204. * Operations related to creating a new track
  1205. * @param {JitsiLocalTrack} newTrack the new track being created
  1206. */
  1207. JitsiConference.prototype._setupNewTrack = function(newTrack) {
  1208. const mediaType = newTrack.getType();
  1209. if (newTrack.isAudioTrack() || (newTrack.isVideoTrack() && newTrack.videoType !== VideoType.DESKTOP)) {
  1210. // Report active device to statistics
  1211. const devices = RTC.getCurrentlyAvailableMediaDevices();
  1212. const device = devices
  1213. .find(d => d.kind === `${newTrack.getTrack().kind}input` && d.label === newTrack.getTrack().label);
  1214. if (device) {
  1215. Statistics.sendActiveDeviceListEvent(RTC.getEventDataForActiveDevice(device));
  1216. }
  1217. }
  1218. // Create a source name for this track if it doesn't exist.
  1219. if (FeatureFlags.isSourceNameSignalingEnabled() && !newTrack.getSourceName()) {
  1220. const sourceName = getSourceNameForJitsiTrack(
  1221. this.myUserId(),
  1222. mediaType,
  1223. this.getLocalTracks(mediaType)?.length);
  1224. newTrack.setSourceName(sourceName);
  1225. }
  1226. this.rtc.addLocalTrack(newTrack);
  1227. newTrack.setConference(this);
  1228. // Add event handlers.
  1229. newTrack.muteHandler = this._fireMuteChangeEvent.bind(this, newTrack);
  1230. newTrack.addEventListener(JitsiTrackEvents.TRACK_MUTE_CHANGED, newTrack.muteHandler);
  1231. if (newTrack.isAudioTrack()) {
  1232. newTrack.audioLevelHandler = this._fireAudioLevelChangeEvent.bind(this);
  1233. newTrack.addEventListener(JitsiTrackEvents.TRACK_AUDIO_LEVEL_CHANGED, newTrack.audioLevelHandler);
  1234. }
  1235. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_ADDED, newTrack);
  1236. };
  1237. /**
  1238. * Sets the video type.
  1239. * @param track
  1240. * @return <tt>true</tt> if video type was changed in presence.
  1241. * @private
  1242. */
  1243. JitsiConference.prototype._setNewVideoType = function(track) {
  1244. let videoTypeChanged = false;
  1245. if (FeatureFlags.isSourceNameSignalingEnabled() && track) {
  1246. videoTypeChanged = this._signalingLayer.setTrackVideoType(track.getSourceName(), track.videoType);
  1247. }
  1248. if (!FeatureFlags.isMultiStreamSupportEnabled()) {
  1249. const videoTypeTagName = 'videoType';
  1250. // If track is missing we revert to default type Camera, the case where we screenshare and
  1251. // we return to be video muted.
  1252. const trackVideoType = track ? track.videoType : VideoType.CAMERA;
  1253. // If video type is camera and there is no videoType in presence, we skip adding it, as this is the default one
  1254. if (trackVideoType !== VideoType.CAMERA || this.room.getFromPresence(videoTypeTagName)) {
  1255. // We will not use this.sendCommand here to avoid sending the presence immediately, as later we may also
  1256. // set the mute status.
  1257. const legacyTypeChanged = this.room.addOrReplaceInPresence(videoTypeTagName, { value: trackVideoType });
  1258. videoTypeChanged = videoTypeChanged || legacyTypeChanged;
  1259. }
  1260. }
  1261. return videoTypeChanged;
  1262. };
  1263. /**
  1264. * Sets mute status.
  1265. * @param mediaType
  1266. * @param localTrack
  1267. * @param isMuted
  1268. * @param <tt>true</tt> when presence was changed, <tt>false</tt> otherwise.
  1269. * @private
  1270. */
  1271. JitsiConference.prototype._setTrackMuteStatus = function(mediaType, localTrack, isMuted) {
  1272. let presenceChanged = false;
  1273. if (FeatureFlags.isSourceNameSignalingEnabled() && localTrack) {
  1274. presenceChanged = this._signalingLayer.setTrackMuteStatus(localTrack.getSourceName(), isMuted);
  1275. }
  1276. // Add the 'audioMuted' and 'videoMuted' tags when source name signaling is enabled for backward compatibility.
  1277. // It won't be used anymore when multiple stream support is enabled.
  1278. if (!FeatureFlags.isMultiStreamSupportEnabled()) {
  1279. let audioMuteChanged, videoMuteChanged;
  1280. if (!this.room) {
  1281. return false;
  1282. }
  1283. if (mediaType === MediaType.AUDIO) {
  1284. audioMuteChanged = this.room.addAudioInfoToPresence(isMuted);
  1285. } else {
  1286. videoMuteChanged = this.room.addVideoInfoToPresence(isMuted);
  1287. }
  1288. presenceChanged = presenceChanged || audioMuteChanged || videoMuteChanged;
  1289. }
  1290. return presenceChanged;
  1291. };
  1292. /**
  1293. * Method called by the {@link JitsiLocalTrack} in order to add the underlying MediaStream to the RTCPeerConnection.
  1294. *
  1295. * @param {JitsiLocalTrack} track the local track that will be added to the pc.
  1296. * @return {Promise} resolved when the process is done or rejected with a string which describes the error.
  1297. */
  1298. JitsiConference.prototype._addLocalTrackToPc = function(track) {
  1299. const addPromises = [];
  1300. if (this.jvbJingleSession) {
  1301. addPromises.push(this.jvbJingleSession.addTrackToPc(track));
  1302. } else {
  1303. logger.debug('Add local MediaStream - no JVB Jingle session started yet');
  1304. }
  1305. if (this.p2pJingleSession) {
  1306. addPromises.push(this.p2pJingleSession.addTrackToPc(track));
  1307. } else {
  1308. logger.debug('Add local MediaStream - no P2P Jingle session started yet');
  1309. }
  1310. return Promise.allSettled(addPromises);
  1311. };
  1312. /**
  1313. * Method called by the {@link JitsiLocalTrack} in order to remove the underlying MediaStream from the
  1314. * RTCPeerConnection.
  1315. *
  1316. * @param {JitsiLocalTrack} track the local track that will be removed.
  1317. * @return {Promise} resolved when the process is done or rejected with a string which describes the error.
  1318. */
  1319. JitsiConference.prototype._removeLocalTrackFromPc = function(track) {
  1320. const removePromises = [];
  1321. if (this.jvbJingleSession) {
  1322. removePromises.push(this.jvbJingleSession.removeTrackFromPc(track));
  1323. } else {
  1324. logger.debug('Remove local MediaStream - no JVB JingleSession started yet');
  1325. }
  1326. if (this.p2pJingleSession) {
  1327. removePromises.push(this.p2pJingleSession.removeTrackFromPc(track));
  1328. } else {
  1329. logger.debug('Remove local MediaStream - no P2P JingleSession started yet');
  1330. }
  1331. return Promise.allSettled(removePromises);
  1332. };
  1333. /**
  1334. * Get role of the local user.
  1335. * @returns {string} user role: 'moderator' or 'none'
  1336. */
  1337. JitsiConference.prototype.getRole = function() {
  1338. return this.room.role;
  1339. };
  1340. /**
  1341. * Returns whether or not the current conference has been joined as a hidden
  1342. * user.
  1343. *
  1344. * @returns {boolean|null} True if hidden, false otherwise. Will return null if
  1345. * no connection is active.
  1346. */
  1347. JitsiConference.prototype.isHidden = function() {
  1348. if (!this.connection) {
  1349. return null;
  1350. }
  1351. return Strophe.getDomainFromJid(this.connection.getJid())
  1352. === this.options.config.hiddenDomain;
  1353. };
  1354. /**
  1355. * Check if local user is moderator.
  1356. * @returns {boolean|null} true if local user is moderator, false otherwise. If
  1357. * we're no longer in the conference room then <tt>null</tt> is returned.
  1358. */
  1359. JitsiConference.prototype.isModerator = function() {
  1360. return this.room ? this.room.isModerator() : null;
  1361. };
  1362. /**
  1363. * Set password for the room.
  1364. * @param {string} password new password for the room.
  1365. * @returns {Promise}
  1366. */
  1367. JitsiConference.prototype.lock = function(password) {
  1368. if (!this.isModerator()) {
  1369. return Promise.reject(new Error('You are not moderator.'));
  1370. }
  1371. return new Promise((resolve, reject) => {
  1372. this.room.lockRoom(
  1373. password || '',
  1374. () => resolve(),
  1375. err => reject(err),
  1376. () => reject(JitsiConferenceErrors.PASSWORD_NOT_SUPPORTED));
  1377. });
  1378. };
  1379. /**
  1380. * Remove password from the room.
  1381. * @returns {Promise}
  1382. */
  1383. JitsiConference.prototype.unlock = function() {
  1384. return this.lock();
  1385. };
  1386. /**
  1387. * Elects the participant with the given id to be the selected participant in
  1388. * order to receive higher video quality (if simulcast is enabled).
  1389. * Or cache it if channel is not created and send it once channel is available.
  1390. * @param participantId the identifier of the participant
  1391. * @throws NetworkError or InvalidStateError or Error if the operation fails.
  1392. * @returns {void}
  1393. */
  1394. JitsiConference.prototype.selectParticipant = function(participantId) {
  1395. this.selectParticipants([ participantId ]);
  1396. };
  1397. /*
  1398. * Elects participants with given ids to be the selected participants in order
  1399. * to receive higher video quality (if simulcast is enabled). The argument
  1400. * should be an array of participant id strings or an empty array; an error will
  1401. * be thrown if a non-array is passed in. The error is thrown as a layer of
  1402. * protection against passing an invalid argument, as the error will happen in
  1403. * the bridge and may not be visible in the client.
  1404. *
  1405. * @param {Array<strings>} participantIds - An array of identifiers for
  1406. * participants.
  1407. * @returns {void}
  1408. */
  1409. JitsiConference.prototype.selectParticipants = function(participantIds) {
  1410. if (!Array.isArray(participantIds)) {
  1411. throw new Error('Invalid argument; participantIds must be an array.');
  1412. }
  1413. this.receiveVideoController.selectEndpoints(participantIds);
  1414. };
  1415. /**
  1416. * Obtains the current value for "lastN". See {@link setLastN} for more info.
  1417. * @returns {number}
  1418. */
  1419. JitsiConference.prototype.getLastN = function() {
  1420. return this.receiveVideoController.getLastN();
  1421. };
  1422. /**
  1423. * Obtains the forwarded sources list in this conference.
  1424. * @return {Array<string>|null}
  1425. */
  1426. JitsiConference.prototype.getForwardedSources = function() {
  1427. return this.rtc.getForwardedSources();
  1428. };
  1429. /**
  1430. * Selects a new value for "lastN". The requested amount of videos are going
  1431. * to be delivered after the value is in effect. Set to -1 for unlimited or
  1432. * all available videos.
  1433. * @param lastN the new number of videos the user would like to receive.
  1434. * @throws Error or RangeError if the given value is not a number or is smaller
  1435. * than -1.
  1436. */
  1437. JitsiConference.prototype.setLastN = function(lastN) {
  1438. if (!Number.isInteger(lastN) && !Number.parseInt(lastN, 10)) {
  1439. throw new Error(`Invalid value for lastN: ${lastN}`);
  1440. }
  1441. const n = Number(lastN);
  1442. if (n < -1) {
  1443. throw new RangeError('lastN cannot be smaller than -1');
  1444. }
  1445. this.receiveVideoController.setLastN(n);
  1446. // If the P2P session is not fully established yet, we wait until it gets
  1447. // established.
  1448. if (this.p2pJingleSession) {
  1449. const isVideoActive = n !== 0;
  1450. this.p2pJingleSession
  1451. .setMediaTransferActive(true, isVideoActive)
  1452. .catch(error => {
  1453. logger.error(
  1454. `Failed to adjust video transfer status (${isVideoActive})`,
  1455. error);
  1456. });
  1457. }
  1458. };
  1459. /**
  1460. * Checks if the participant given by participantId is currently included in
  1461. * the last N.
  1462. * @param {string} participantId the identifier of the participant we would
  1463. * like to check.
  1464. * @return {boolean} true if the participant with id is in the last N set or
  1465. * if there's no last N set, false otherwise.
  1466. * @deprecated this method should never be used to figure out the UI, but
  1467. * {@link ParticipantConnectionStatus} should be used instead.
  1468. */
  1469. JitsiConference.prototype.isInLastN = function(participantId) {
  1470. return this.rtc.isInLastN(participantId);
  1471. };
  1472. /**
  1473. * @return Array<JitsiParticipant> an array of all participants in this
  1474. * conference.
  1475. */
  1476. JitsiConference.prototype.getParticipants = function() {
  1477. return Object.values(this.participants);
  1478. };
  1479. /**
  1480. * Returns the number of participants in the conference, including the local
  1481. * participant.
  1482. * @param countHidden {boolean} Whether or not to include hidden participants
  1483. * in the count. Default: false.
  1484. **/
  1485. JitsiConference.prototype.getParticipantCount = function(countHidden = false) {
  1486. let participants = this.getParticipants();
  1487. if (!countHidden) {
  1488. participants = participants.filter(p => !p.isHidden());
  1489. }
  1490. // Add one for the local participant.
  1491. return participants.length + 1;
  1492. };
  1493. /**
  1494. * @returns {JitsiParticipant} the participant in this conference with the
  1495. * specified id (or undefined if there isn't one).
  1496. * @param id the id of the participant.
  1497. */
  1498. JitsiConference.prototype.getParticipantById = function(id) {
  1499. return this.participants[id];
  1500. };
  1501. /**
  1502. * Grant owner rights to the participant.
  1503. * @param {string} id id of the participant to grant owner rights to.
  1504. */
  1505. JitsiConference.prototype.grantOwner = function(id) {
  1506. const participant = this.getParticipantById(id);
  1507. if (!participant) {
  1508. return;
  1509. }
  1510. this.room.setAffiliation(participant.getConnectionJid(), 'owner');
  1511. };
  1512. /**
  1513. * Revoke owner rights to the participant or local Participant as
  1514. * the user might want to refuse to be a moderator.
  1515. * @param {string} id id of the participant to revoke owner rights to.
  1516. */
  1517. JitsiConference.prototype.revokeOwner = function(id) {
  1518. const participant = this.getParticipantById(id);
  1519. const isMyself = this.myUserId() === id;
  1520. const role = this.isMembersOnly() ? 'member' : 'none';
  1521. if (isMyself) {
  1522. this.room.setAffiliation(this.connection.getJid(), role);
  1523. } else if (participant) {
  1524. this.room.setAffiliation(participant.getConnectionJid(), role);
  1525. }
  1526. };
  1527. /**
  1528. * Kick participant from this conference.
  1529. * @param {string} id id of the participant to kick
  1530. * @param {string} reason reason of the participant to kick
  1531. */
  1532. JitsiConference.prototype.kickParticipant = function(id, reason) {
  1533. const participant = this.getParticipantById(id);
  1534. if (!participant) {
  1535. return;
  1536. }
  1537. this.room.kick(participant.getJid(), reason);
  1538. };
  1539. /**
  1540. * Maybe clears the timeout which emits {@link ACTION_JINGLE_SI_TIMEOUT}
  1541. * analytics event.
  1542. * @private
  1543. */
  1544. JitsiConference.prototype._maybeClearSITimeout = function() {
  1545. if (this._sessionInitiateTimeout
  1546. && (this.jvbJingleSession || this.getParticipantCount() < 2)) {
  1547. window.clearTimeout(this._sessionInitiateTimeout);
  1548. this._sessionInitiateTimeout = null;
  1549. }
  1550. };
  1551. /**
  1552. * Sets a timeout which will emit {@link ACTION_JINGLE_SI_TIMEOUT} analytics
  1553. * event.
  1554. * @private
  1555. */
  1556. JitsiConference.prototype._maybeSetSITimeout = function() {
  1557. // Jicofo is supposed to invite if there are at least 2 participants
  1558. if (!this.jvbJingleSession
  1559. && this.getParticipantCount() >= 2
  1560. && !this._sessionInitiateTimeout) {
  1561. this._sessionInitiateTimeout = window.setTimeout(() => {
  1562. this._sessionInitiateTimeout = null;
  1563. Statistics.sendAnalytics(createJingleEvent(
  1564. ACTION_JINGLE_SI_TIMEOUT,
  1565. {
  1566. p2p: false,
  1567. value: JINGLE_SI_TIMEOUT
  1568. }));
  1569. }, JINGLE_SI_TIMEOUT);
  1570. }
  1571. };
  1572. /**
  1573. * Mutes a participant.
  1574. * @param {string} id The id of the participant to mute.
  1575. */
  1576. JitsiConference.prototype.muteParticipant = function(id, mediaType) {
  1577. const muteMediaType = mediaType ? mediaType : MediaType.AUDIO;
  1578. if (muteMediaType !== MediaType.AUDIO && muteMediaType !== MediaType.VIDEO) {
  1579. logger.error(`Unsupported media type: ${muteMediaType}`);
  1580. return;
  1581. }
  1582. const participant = this.getParticipantById(id);
  1583. if (!participant) {
  1584. return;
  1585. }
  1586. this.room.muteParticipant(participant.getJid(), true, muteMediaType);
  1587. };
  1588. /* eslint-disable max-params */
  1589. /**
  1590. * Notifies this JitsiConference that a new member has joined its chat room.
  1591. *
  1592. * FIXME This should NOT be exposed!
  1593. *
  1594. * @param jid the jid of the participant in the MUC
  1595. * @param nick the display name of the participant
  1596. * @param role the role of the participant in the MUC
  1597. * @param isHidden indicates if this is a hidden participant (system
  1598. * participant for example a recorder).
  1599. * @param statsID the participant statsID (optional)
  1600. * @param status the initial status if any
  1601. * @param identity the member identity, if any
  1602. * @param botType the member botType, if any
  1603. * @param fullJid the member full jid, if any
  1604. * @param features the member botType, if any
  1605. * @param isReplaceParticipant whether this join replaces a participant with
  1606. * the same jwt.
  1607. */
  1608. JitsiConference.prototype.onMemberJoined = function(
  1609. jid, nick, role, isHidden, statsID, status, identity, botType, fullJid, features, isReplaceParticipant) {
  1610. const id = Strophe.getResourceFromJid(jid);
  1611. if (id === 'focus' || this.myUserId() === id) {
  1612. return;
  1613. }
  1614. const participant
  1615. = new JitsiParticipant(jid, this, nick, isHidden, statsID, status, identity);
  1616. participant.setConnectionJid(fullJid);
  1617. participant.setRole(role);
  1618. participant.setBotType(botType);
  1619. participant.setFeatures(features);
  1620. participant.setIsReplacing(isReplaceParticipant);
  1621. this.participants[id] = participant;
  1622. this.eventEmitter.emit(
  1623. JitsiConferenceEvents.USER_JOINED,
  1624. id,
  1625. participant);
  1626. this._updateFeatures(participant);
  1627. // maybeStart only if we had finished joining as then we will have information for the number of participants
  1628. if (this.isJoined()) {
  1629. this._maybeStartOrStopP2P();
  1630. }
  1631. this._maybeSetSITimeout();
  1632. };
  1633. /* eslint-enable max-params */
  1634. /**
  1635. * Get notified when we joined the room.
  1636. *
  1637. * FIXME This should NOT be exposed!
  1638. *
  1639. * @private
  1640. */
  1641. JitsiConference.prototype._onMucJoined = function() {
  1642. this._maybeStartOrStopP2P();
  1643. };
  1644. /**
  1645. * Updates features for a participant.
  1646. * @param {JitsiParticipant} participant - The participant to query for features.
  1647. * @returns {void}
  1648. * @private
  1649. */
  1650. JitsiConference.prototype._updateFeatures = function(participant) {
  1651. participant.getFeatures()
  1652. .then(features => {
  1653. participant._supportsDTMF = features.has('urn:xmpp:jingle:dtmf:0');
  1654. this.updateDTMFSupport();
  1655. if (features.has(FEATURE_JIGASI)) {
  1656. participant.setProperty('features_jigasi', true);
  1657. }
  1658. if (features.has(FEATURE_E2EE)) {
  1659. participant.setProperty('features_e2ee', true);
  1660. }
  1661. })
  1662. .catch(() => false);
  1663. };
  1664. /**
  1665. * Get notified when member bot type had changed.
  1666. * @param jid the member jid
  1667. * @param botType the new botType value
  1668. * @private
  1669. */
  1670. JitsiConference.prototype._onMemberBotTypeChanged = function(jid, botType) {
  1671. // find the participant and mark it as non bot, as the real one will join
  1672. // in a moment
  1673. const peers = this.getParticipants();
  1674. const botParticipant = peers.find(p => p.getJid() === jid);
  1675. if (botParticipant) {
  1676. botParticipant.setBotType(botType);
  1677. const id = Strophe.getResourceFromJid(jid);
  1678. this.eventEmitter.emit(
  1679. JitsiConferenceEvents.BOT_TYPE_CHANGED,
  1680. id,
  1681. botType);
  1682. }
  1683. // if botType changed to undefined, botType was removed, in case of
  1684. // poltergeist mode this is the moment when the poltergeist had exited and
  1685. // the real participant had already replaced it.
  1686. // In this case we can check and try p2p
  1687. if (!botParticipant.getBotType()) {
  1688. this._maybeStartOrStopP2P();
  1689. }
  1690. };
  1691. JitsiConference.prototype.onMemberLeft = function(jid, reason) {
  1692. const id = Strophe.getResourceFromJid(jid);
  1693. if (id === 'focus' || this.myUserId() === id) {
  1694. return;
  1695. }
  1696. const participant = this.participants[id];
  1697. const mediaSessions = this.getMediaSessions();
  1698. let tracksToBeRemoved = [];
  1699. for (const session of mediaSessions) {
  1700. const remoteTracks = session.peerconnection.getRemoteTracks(id);
  1701. remoteTracks && (tracksToBeRemoved = [ ...tracksToBeRemoved, ...remoteTracks ]);
  1702. // Remove the ssrcs from the remote description and renegotiate.
  1703. session.removeRemoteStreamsOnLeave(id);
  1704. }
  1705. // Fire the event before renegotiation is done so that the thumbnails can be removed immediately.
  1706. tracksToBeRemoved.forEach(track => {
  1707. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_REMOVED, track);
  1708. });
  1709. if (participant) {
  1710. delete this.participants[id];
  1711. this.eventEmitter.emit(JitsiConferenceEvents.USER_LEFT, id, participant, reason);
  1712. }
  1713. if (this.room !== null) { // Skip if we have left the room already.
  1714. this._maybeStartOrStopP2P(true /* triggered by user left event */);
  1715. this._maybeClearSITimeout();
  1716. }
  1717. };
  1718. /* eslint-disable max-params */
  1719. /**
  1720. * Designates an event indicating that we were kicked from the XMPP MUC.
  1721. * @param {boolean} isSelfPresence - whether it is for local participant
  1722. * or another participant.
  1723. * @param {string} actorId - the id of the participant who was initiator
  1724. * of the kick.
  1725. * @param {string?} kickedParticipantId - when it is not a kick for local participant,
  1726. * this is the id of the participant which was kicked.
  1727. * @param {string} reason - reason of the participant to kick
  1728. * @param {boolean?} isReplaceParticipant - whether this is a server initiated kick in order
  1729. * to replace it with a participant with same jwt.
  1730. */
  1731. JitsiConference.prototype.onMemberKicked = function(
  1732. isSelfPresence,
  1733. actorId,
  1734. kickedParticipantId,
  1735. reason,
  1736. isReplaceParticipant) {
  1737. // This check which be true when we kick someone else. With the introduction of lobby
  1738. // the ChatRoom KICKED event is now also emitted for ourselves (the kicker) so we want to
  1739. // avoid emitting an event where `undefined` kicked someone.
  1740. if (actorId === this.myUserId()) {
  1741. return;
  1742. }
  1743. const actorParticipant = this.participants[actorId];
  1744. if (isSelfPresence) {
  1745. this.eventEmitter.emit(
  1746. JitsiConferenceEvents.KICKED, actorParticipant, reason, isReplaceParticipant);
  1747. this.leave();
  1748. return;
  1749. }
  1750. const kickedParticipant = this.participants[kickedParticipantId];
  1751. kickedParticipant.setIsReplaced(isReplaceParticipant);
  1752. this.eventEmitter.emit(
  1753. JitsiConferenceEvents.PARTICIPANT_KICKED, actorParticipant, kickedParticipant, reason);
  1754. };
  1755. /**
  1756. * Method called on local MUC role change.
  1757. * @param {string} role the name of new user's role as defined by XMPP MUC.
  1758. */
  1759. JitsiConference.prototype.onLocalRoleChanged = function(role) {
  1760. // Emit role changed for local JID
  1761. this.eventEmitter.emit(
  1762. JitsiConferenceEvents.USER_ROLE_CHANGED, this.myUserId(), role);
  1763. };
  1764. JitsiConference.prototype.onUserRoleChanged = function(jid, role) {
  1765. const id = Strophe.getResourceFromJid(jid);
  1766. const participant = this.getParticipantById(id);
  1767. if (!participant) {
  1768. return;
  1769. }
  1770. participant.setRole(role);
  1771. this.eventEmitter.emit(JitsiConferenceEvents.USER_ROLE_CHANGED, id, role);
  1772. };
  1773. JitsiConference.prototype.onDisplayNameChanged = function(jid, displayName) {
  1774. const id = Strophe.getResourceFromJid(jid);
  1775. const participant = this.getParticipantById(id);
  1776. if (!participant) {
  1777. return;
  1778. }
  1779. if (participant._displayName === displayName) {
  1780. return;
  1781. }
  1782. participant._displayName = displayName;
  1783. this.eventEmitter.emit(
  1784. JitsiConferenceEvents.DISPLAY_NAME_CHANGED,
  1785. id,
  1786. displayName);
  1787. };
  1788. /**
  1789. * Notifies this JitsiConference that a JitsiRemoteTrack was added to the conference.
  1790. *
  1791. * @param {JitsiRemoteTrack} track the JitsiRemoteTrack which was added to this JitsiConference.
  1792. */
  1793. JitsiConference.prototype.onRemoteTrackAdded = function(track) {
  1794. if (track.isP2P && !this.isP2PActive()) {
  1795. logger.info('Trying to add remote P2P track, when not in P2P - IGNORED');
  1796. return;
  1797. } else if (!track.isP2P && this.isP2PActive()) {
  1798. logger.info('Trying to add remote JVB track, when in P2P - IGNORED');
  1799. return;
  1800. }
  1801. const id = track.getParticipantId();
  1802. const participant = this.getParticipantById(id);
  1803. if (!participant) {
  1804. logger.error(`No participant found for id: ${id}`);
  1805. return;
  1806. }
  1807. // Add track to JitsiParticipant.
  1808. participant._tracks.push(track);
  1809. if (this.transcriber) {
  1810. this.transcriber.addTrack(track);
  1811. }
  1812. const emitter = this.eventEmitter;
  1813. track.addEventListener(
  1814. JitsiTrackEvents.TRACK_MUTE_CHANGED,
  1815. () => emitter.emit(JitsiConferenceEvents.TRACK_MUTE_CHANGED, track));
  1816. track.isAudioTrack() && track.addEventListener(
  1817. JitsiTrackEvents.TRACK_AUDIO_LEVEL_CHANGED,
  1818. (audioLevel, tpc) => {
  1819. const activeTPC = this.getActivePeerConnection();
  1820. if (activeTPC === tpc) {
  1821. emitter.emit(JitsiConferenceEvents.TRACK_AUDIO_LEVEL_CHANGED, id, audioLevel);
  1822. }
  1823. }
  1824. );
  1825. emitter.emit(JitsiConferenceEvents.TRACK_ADDED, track);
  1826. };
  1827. /**
  1828. * Callback called by the Jingle plugin when 'session-answer' is received.
  1829. * @param {JingleSessionPC} session the Jingle session for which an answer was
  1830. * received.
  1831. * @param {jQuery} answer a jQuery selector pointing to 'jingle' IQ element
  1832. */
  1833. // eslint-disable-next-line no-unused-vars
  1834. JitsiConference.prototype.onCallAccepted = function(session, answer) {
  1835. if (this.p2pJingleSession === session) {
  1836. logger.info('P2P setAnswer');
  1837. this.p2pJingleSession.setAnswer(answer);
  1838. this.eventEmitter.emit(JitsiConferenceEvents._MEDIA_SESSION_STARTED, this.p2pJingleSession);
  1839. }
  1840. };
  1841. /**
  1842. * Callback called by the Jingle plugin when 'transport-info' is received.
  1843. * @param {JingleSessionPC} session the Jingle session for which the IQ was
  1844. * received
  1845. * @param {jQuery} transportInfo a jQuery selector pointing to 'jingle' IQ
  1846. * element
  1847. */
  1848. // eslint-disable-next-line no-unused-vars
  1849. JitsiConference.prototype.onTransportInfo = function(session, transportInfo) {
  1850. if (this.p2pJingleSession === session) {
  1851. logger.info('P2P addIceCandidates');
  1852. this.p2pJingleSession.addIceCandidates(transportInfo);
  1853. }
  1854. };
  1855. /**
  1856. * Notifies this JitsiConference that a JitsiRemoteTrack was removed from
  1857. * the conference.
  1858. *
  1859. * @param {JitsiRemoteTrack} removedTrack
  1860. */
  1861. JitsiConference.prototype.onRemoteTrackRemoved = function(removedTrack) {
  1862. this.getParticipants().forEach(participant => {
  1863. const tracks = participant.getTracks();
  1864. for (let i = 0; i < tracks.length; i++) {
  1865. if (tracks[i] === removedTrack) {
  1866. // Since the tracks have been compared and are
  1867. // considered equal the result of splice can be ignored.
  1868. participant._tracks.splice(i, 1);
  1869. this.eventEmitter.emit(JitsiConferenceEvents.TRACK_REMOVED, removedTrack);
  1870. if (this.transcriber) {
  1871. this.transcriber.removeTrack(removedTrack);
  1872. }
  1873. break;
  1874. }
  1875. }
  1876. }, this);
  1877. };
  1878. /**
  1879. * Handles an incoming call event for the P2P jingle session.
  1880. */
  1881. JitsiConference.prototype._onIncomingCallP2P = function(jingleSession, jingleOffer) {
  1882. let rejectReason;
  1883. const usesUnifiedPlan = browser.supportsUnifiedPlan()
  1884. && (!browser.isChromiumBased() || (this.options.config.enableUnifiedOnChrome ?? true));
  1885. const contentName = jingleOffer.find('>content').attr('name');
  1886. const peerUsesUnifiedPlan = contentName === '0' || contentName === '1';
  1887. // Reject P2P between endpoints that are not running in the same mode w.r.t to SDPs (plan-b and unified plan).
  1888. if (usesUnifiedPlan !== peerUsesUnifiedPlan) {
  1889. rejectReason = {
  1890. reason: 'decline',
  1891. reasonDescription: 'P2P disabled',
  1892. errorMsg: 'P2P across two endpoints in different SDP modes is disabled'
  1893. };
  1894. } else if ((!this.isP2PEnabled() && !this.isP2PTestModeEnabled())
  1895. || browser.isFirefox()
  1896. || browser.isWebKitBased()) {
  1897. rejectReason = {
  1898. reason: 'decline',
  1899. reasonDescription: 'P2P disabled',
  1900. errorMsg: 'P2P mode disabled in the configuration or browser unsupported'
  1901. };
  1902. } else if (this.p2pJingleSession) {
  1903. // Reject incoming P2P call (already in progress)
  1904. rejectReason = {
  1905. reason: 'busy',
  1906. reasonDescription: 'P2P already in progress',
  1907. errorMsg: 'Duplicated P2P "session-initiate"'
  1908. };
  1909. } else if (!this._shouldBeInP2PMode()) {
  1910. rejectReason = {
  1911. reason: 'decline',
  1912. reasonDescription: 'P2P requirements not met',
  1913. errorMsg: 'Received P2P "session-initiate" when should not be in P2P mode'
  1914. };
  1915. Statistics.sendAnalytics(createJingleEvent(ACTION_P2P_DECLINED));
  1916. }
  1917. if (rejectReason) {
  1918. this._rejectIncomingCall(jingleSession, rejectReason);
  1919. } else {
  1920. this._acceptP2PIncomingCall(jingleSession, jingleOffer);
  1921. }
  1922. };
  1923. /**
  1924. * Handles an incoming call event.
  1925. */
  1926. JitsiConference.prototype.onIncomingCall = function(jingleSession, jingleOffer, now) {
  1927. // Handle incoming P2P call
  1928. if (jingleSession.isP2P) {
  1929. this._onIncomingCallP2P(jingleSession, jingleOffer);
  1930. } else {
  1931. if (!this.isFocus(jingleSession.remoteJid)) {
  1932. const description = 'Rejecting session-initiate from non-focus.';
  1933. this._rejectIncomingCall(
  1934. jingleSession, {
  1935. reason: 'security-error',
  1936. reasonDescription: description,
  1937. errorMsg: description
  1938. });
  1939. return;
  1940. }
  1941. this._acceptJvbIncomingCall(jingleSession, jingleOffer, now);
  1942. }
  1943. };
  1944. /**
  1945. * Accepts an incoming call event for the JVB jingle session.
  1946. */
  1947. JitsiConference.prototype._acceptJvbIncomingCall = function(jingleSession, jingleOffer, now) {
  1948. // Accept incoming call
  1949. this.jvbJingleSession = jingleSession;
  1950. this.room.connectionTimes['session.initiate'] = now;
  1951. this._sendConferenceJoinAnalyticsEvent();
  1952. if (this.wasStopped) {
  1953. Statistics.sendAnalyticsAndLog(createJingleEvent(ACTION_JINGLE_RESTART, { p2p: false }));
  1954. }
  1955. const serverRegion
  1956. = $(jingleOffer)
  1957. .find('>bridge-session[xmlns="http://jitsi.org/protocol/focus"]')
  1958. .attr('region');
  1959. this.eventEmitter.emit(JitsiConferenceEvents.SERVER_REGION_CHANGED, serverRegion);
  1960. this._maybeClearSITimeout();
  1961. Statistics.sendAnalytics(createJingleEvent(
  1962. ACTION_JINGLE_SI_RECEIVED,
  1963. {
  1964. p2p: false,
  1965. value: now
  1966. }));
  1967. try {
  1968. jingleSession.initialize(
  1969. this.room,
  1970. this.rtc,
  1971. this._signalingLayer,
  1972. {
  1973. ...this.options.config,
  1974. enableInsertableStreams: this.isE2EEEnabled()
  1975. });
  1976. } catch (error) {
  1977. GlobalOnErrorHandler.callErrorHandler(error);
  1978. logger.error(error);
  1979. return;
  1980. }
  1981. // Open a channel with the videobridge.
  1982. this._setBridgeChannel(jingleOffer, jingleSession.peerconnection);
  1983. const localTracks = this._getInitialLocalTracks();
  1984. try {
  1985. jingleSession.acceptOffer(
  1986. jingleOffer,
  1987. () => {
  1988. // If for any reason invite for the JVB session arrived after
  1989. // the P2P has been established already the media transfer needs
  1990. // to be turned off here.
  1991. if (this.isP2PActive() && this.jvbJingleSession) {
  1992. this._suspendMediaTransferForJvbConnection();
  1993. }
  1994. this.eventEmitter.emit(JitsiConferenceEvents._MEDIA_SESSION_STARTED, jingleSession);
  1995. if (!this.isP2PActive()) {
  1996. this.eventEmitter.emit(JitsiConferenceEvents._MEDIA_SESSION_ACTIVE_CHANGED, jingleSession);
  1997. }
  1998. },
  1999. error => {
  2000. GlobalOnErrorHandler.callErrorHandler(error);
  2001. logger.error('Failed to accept incoming Jingle session', error);
  2002. },
  2003. localTracks
  2004. );
  2005. // Enable or disable simulcast for plan-b screensharing based on the capture fps if it is set through the UI.
  2006. this._desktopSharingFrameRate
  2007. && jingleSession.peerconnection.setDesktopSharingFrameRate(this._desktopSharingFrameRate);
  2008. // Start callstats as soon as peerconnection is initialized,
  2009. // do not wait for XMPPEvents.PEERCONNECTION_READY, as it may never
  2010. // happen in case if user doesn't have or denied permission to
  2011. // both camera and microphone.
  2012. logger.info('Starting CallStats for JVB connection...');
  2013. this.statistics.startCallStats(
  2014. this.jvbJingleSession.peerconnection,
  2015. 'jitsi' /* Remote user ID for JVB is 'jitsi' */);
  2016. this.statistics.startRemoteStats(this.jvbJingleSession.peerconnection);
  2017. } catch (e) {
  2018. GlobalOnErrorHandler.callErrorHandler(e);
  2019. logger.error(e);
  2020. }
  2021. };
  2022. /**
  2023. * Sets the BridgeChannel.
  2024. *
  2025. * @param {jQuery} offerIq a jQuery selector pointing to the jingle element of
  2026. * the offer IQ which may carry the WebSocket URL for the 'websocket'
  2027. * BridgeChannel mode.
  2028. * @param {TraceablePeerConnection} pc the peer connection which will be used
  2029. * to listen for new WebRTC Data Channels (in the 'datachannel' mode).
  2030. */
  2031. JitsiConference.prototype._setBridgeChannel = function(offerIq, pc) {
  2032. let wsUrl = null;
  2033. const webSocket
  2034. = $(offerIq)
  2035. .find('>content>transport>web-socket')
  2036. .first();
  2037. if (webSocket.length === 1) {
  2038. wsUrl = webSocket[0].getAttribute('url');
  2039. }
  2040. if (wsUrl) {
  2041. // If the offer contains a websocket use it.
  2042. this.rtc.initializeBridgeChannel(null, wsUrl);
  2043. } else {
  2044. // Otherwise, fall back to an attempt to use SCTP.
  2045. this.rtc.initializeBridgeChannel(pc, null);
  2046. }
  2047. };
  2048. /**
  2049. * Rejects incoming Jingle call.
  2050. * @param {JingleSessionPC} jingleSession the session instance to be rejected.
  2051. * @param {object} [options]
  2052. * @param {string} options.reason the name of the reason element as defined
  2053. * by Jingle
  2054. * @param {string} options.reasonDescription the reason description which will
  2055. * be included in Jingle 'session-terminate' message.
  2056. * @param {string} options.errorMsg an error message to be logged on global
  2057. * error handler
  2058. * @private
  2059. */
  2060. JitsiConference.prototype._rejectIncomingCall = function(jingleSession, options) {
  2061. if (options?.errorMsg) {
  2062. logger.warn(options.errorMsg);
  2063. }
  2064. // Terminate the jingle session with a reason
  2065. jingleSession.terminate(
  2066. null /* success callback => we don't care */,
  2067. error => {
  2068. logger.warn(
  2069. 'An error occurred while trying to terminate'
  2070. + ' invalid Jingle session', error);
  2071. }, {
  2072. reason: options && options.reason,
  2073. reasonDescription: options && options.reasonDescription,
  2074. sendSessionTerminate: true
  2075. });
  2076. };
  2077. /**
  2078. * Handles the call ended event.
  2079. * XXX is this due to the remote side terminating the Jingle session?
  2080. *
  2081. * @param {JingleSessionPC} jingleSession the jingle session which has been
  2082. * terminated.
  2083. * @param {String} reasonCondition the Jingle reason condition.
  2084. * @param {String|null} reasonText human readable reason text which may provide
  2085. * more details about why the call has been terminated.
  2086. */
  2087. JitsiConference.prototype.onCallEnded = function(jingleSession, reasonCondition, reasonText) {
  2088. logger.info(
  2089. `Call ended: ${reasonCondition} - ${reasonText} P2P ?${
  2090. jingleSession.isP2P}`);
  2091. if (jingleSession === this.jvbJingleSession) {
  2092. this.wasStopped = true;
  2093. Statistics.sendAnalytics(
  2094. createJingleEvent(ACTION_JINGLE_TERMINATE, { p2p: false }));
  2095. // Stop the stats
  2096. if (this.statistics) {
  2097. this.statistics.stopRemoteStats(
  2098. this.jvbJingleSession.peerconnection);
  2099. logger.info('Stopping JVB CallStats');
  2100. this.statistics.stopCallStats(
  2101. this.jvbJingleSession.peerconnection);
  2102. }
  2103. // Current JVB JingleSession is no longer valid, so set it to null
  2104. this.jvbJingleSession = null;
  2105. // Let the RTC service do any cleanups
  2106. this.rtc.onCallEnded();
  2107. } else if (jingleSession === this.p2pJingleSession) {
  2108. const stopOptions = {};
  2109. // It's the responder who decides to enforce JVB mode, so that both
  2110. // initiator and responder are aware if it was intentional.
  2111. if (reasonCondition === 'decline' && reasonText === 'force JVB121') {
  2112. logger.info('In forced JVB 121 mode...');
  2113. Statistics.analytics.addPermanentProperties({ forceJvb121: true });
  2114. } else if (reasonCondition === 'connectivity-error'
  2115. && reasonText === 'ICE FAILED') {
  2116. // It can happen that the other peer detects ICE failed and
  2117. // terminates the session, before we get the event on our side.
  2118. // But we are able to parse the reason and mark it here.
  2119. Statistics.analytics.addPermanentProperties({ p2pFailed: true });
  2120. } else if (reasonCondition === 'success' && reasonText === 'restart') {
  2121. // When we are restarting media sessions we don't want to switch the tracks
  2122. // to the JVB just yet.
  2123. stopOptions.requestRestart = true;
  2124. }
  2125. this._stopP2PSession(stopOptions);
  2126. } else {
  2127. logger.error(
  2128. 'Received onCallEnded for invalid session',
  2129. jingleSession.sid,
  2130. jingleSession.remoteJid,
  2131. reasonCondition,
  2132. reasonText);
  2133. }
  2134. };
  2135. /**
  2136. * Handles the suspend detected event. Leaves the room and fires suspended.
  2137. * @param {JingleSessionPC} jingleSession
  2138. */
  2139. JitsiConference.prototype.onSuspendDetected = function(jingleSession) {
  2140. if (!jingleSession.isP2P) {
  2141. this.leave();
  2142. this.eventEmitter.emit(JitsiConferenceEvents.SUSPEND_DETECTED);
  2143. }
  2144. };
  2145. JitsiConference.prototype.updateDTMFSupport = function() {
  2146. let somebodySupportsDTMF = false;
  2147. const participants = this.getParticipants();
  2148. // check if at least 1 participant supports DTMF
  2149. for (let i = 0; i < participants.length; i += 1) {
  2150. if (participants[i].supportsDTMF()) {
  2151. somebodySupportsDTMF = true;
  2152. break;
  2153. }
  2154. }
  2155. if (somebodySupportsDTMF !== this.somebodySupportsDTMF) {
  2156. this.somebodySupportsDTMF = somebodySupportsDTMF;
  2157. this.eventEmitter.emit(
  2158. JitsiConferenceEvents.DTMF_SUPPORT_CHANGED,
  2159. somebodySupportsDTMF);
  2160. }
  2161. };
  2162. /**
  2163. * Allows to check if there is at least one user in the conference
  2164. * that supports DTMF.
  2165. * @returns {boolean} true if somebody supports DTMF, false otherwise
  2166. */
  2167. JitsiConference.prototype.isDTMFSupported = function() {
  2168. return this.somebodySupportsDTMF;
  2169. };
  2170. /**
  2171. * Returns the local user's ID
  2172. * @return {string} local user's ID
  2173. */
  2174. JitsiConference.prototype.myUserId = function() {
  2175. return (
  2176. this.room && this.room.myroomjid
  2177. ? Strophe.getResourceFromJid(this.room.myroomjid)
  2178. : null);
  2179. };
  2180. JitsiConference.prototype.sendTones = function(tones, duration, pause) {
  2181. const peerConnection = this.getActivePeerConnection();
  2182. if (peerConnection) {
  2183. peerConnection.sendTones(tones, duration, pause);
  2184. } else {
  2185. logger.warn('cannot sendTones: no peer connection');
  2186. }
  2187. };
  2188. /**
  2189. * Starts recording the current conference.
  2190. *
  2191. * @param {Object} options - Configuration for the recording. See
  2192. * {@link Chatroom#startRecording} for more info.
  2193. * @returns {Promise} See {@link Chatroom#startRecording} for more info.
  2194. */
  2195. JitsiConference.prototype.startRecording = function(options) {
  2196. if (this.room) {
  2197. return this.recordingManager.startRecording(options);
  2198. }
  2199. return Promise.reject(new Error('The conference is not created yet!'));
  2200. };
  2201. /**
  2202. * Stop a recording session.
  2203. *
  2204. * @param {string} sessionID - The ID of the recording session that
  2205. * should be stopped.
  2206. * @returns {Promise} See {@link Chatroom#stopRecording} for more info.
  2207. */
  2208. JitsiConference.prototype.stopRecording = function(sessionID) {
  2209. if (this.room) {
  2210. return this.recordingManager.stopRecording(sessionID);
  2211. }
  2212. return Promise.reject(new Error('The conference is not created yet!'));
  2213. };
  2214. /**
  2215. * Returns true if the SIP calls are supported and false otherwise
  2216. */
  2217. JitsiConference.prototype.isSIPCallingSupported = function() {
  2218. if (this.room) {
  2219. return this.room.isSIPCallingSupported();
  2220. }
  2221. return false;
  2222. };
  2223. /**
  2224. * Dials a number.
  2225. * @param number the number
  2226. */
  2227. JitsiConference.prototype.dial = function(number) {
  2228. if (this.room) {
  2229. return this.room.dial(number);
  2230. }
  2231. return new Promise((resolve, reject) => {
  2232. reject(new Error('The conference is not created yet!'));
  2233. });
  2234. };
  2235. /**
  2236. * Hangup an existing call
  2237. */
  2238. JitsiConference.prototype.hangup = function() {
  2239. if (this.room) {
  2240. return this.room.hangup();
  2241. }
  2242. return new Promise((resolve, reject) => {
  2243. reject(new Error('The conference is not created yet!'));
  2244. });
  2245. };
  2246. /**
  2247. * Starts the transcription service.
  2248. */
  2249. JitsiConference.prototype.startTranscriber = function() {
  2250. return this.dial('jitsi_meet_transcribe');
  2251. };
  2252. /**
  2253. * Stops the transcription service.
  2254. */
  2255. JitsiConference.prototype.stopTranscriber = JitsiConference.prototype.hangup;
  2256. /**
  2257. * Returns the phone number for joining the conference.
  2258. */
  2259. JitsiConference.prototype.getPhoneNumber = function() {
  2260. if (this.room) {
  2261. return this.room.getPhoneNumber();
  2262. }
  2263. return null;
  2264. };
  2265. /**
  2266. * Returns the pin for joining the conference with phone.
  2267. */
  2268. JitsiConference.prototype.getPhonePin = function() {
  2269. if (this.room) {
  2270. return this.room.getPhonePin();
  2271. }
  2272. return null;
  2273. };
  2274. /**
  2275. * Returns the meeting unique ID if any.
  2276. *
  2277. * @returns {string|undefined}
  2278. */
  2279. JitsiConference.prototype.getMeetingUniqueId = function() {
  2280. if (this.room) {
  2281. return this.room.getMeetingId();
  2282. }
  2283. };
  2284. /**
  2285. * Will return P2P or JVB <tt>TraceablePeerConnection</tt> depending on
  2286. * which connection is currently active.
  2287. *
  2288. * @return {TraceablePeerConnection|null} null if there isn't any active
  2289. * <tt>TraceablePeerConnection</tt> currently available.
  2290. * @public (FIXME how to make package local ?)
  2291. */
  2292. JitsiConference.prototype.getActivePeerConnection = function() {
  2293. const session = this.isP2PActive() ? this.p2pJingleSession : this.jvbJingleSession;
  2294. return session ? session.peerconnection : null;
  2295. };
  2296. /**
  2297. * Returns the connection state for the current room. Its ice connection state
  2298. * for its session.
  2299. * NOTE that "completed" ICE state which can appear on the P2P connection will
  2300. * be converted to "connected".
  2301. * @return {string|null} ICE state name or <tt>null</tt> if there is no active
  2302. * peer connection at this time.
  2303. */
  2304. JitsiConference.prototype.getConnectionState = function() {
  2305. const peerConnection = this.getActivePeerConnection();
  2306. return peerConnection ? peerConnection.getConnectionState() : null;
  2307. };
  2308. /**
  2309. * Make all new participants mute their audio/video on join.
  2310. * @param policy {Object} object with 2 boolean properties for video and audio:
  2311. * @param {boolean} audio if audio should be muted.
  2312. * @param {boolean} video if video should be muted.
  2313. */
  2314. JitsiConference.prototype.setStartMutedPolicy = function(policy) {
  2315. if (!this.isModerator()) {
  2316. logger.warn(`Failed to set start muted policy, ${this.room ? '' : 'not in a room, '}${
  2317. this.isModerator() ? '' : 'participant is not a moderator'}`);
  2318. return;
  2319. }
  2320. this.startMutedPolicy = policy;
  2321. this.room.addOrReplaceInPresence('startmuted', {
  2322. attributes: {
  2323. audio: policy.audio,
  2324. video: policy.video,
  2325. xmlns: 'http://jitsi.org/jitmeet/start-muted'
  2326. }
  2327. }) && this.room.sendPresence();
  2328. };
  2329. /**
  2330. * Returns current start muted policy
  2331. * @returns {Object} with 2 properties - audio and video.
  2332. */
  2333. JitsiConference.prototype.getStartMutedPolicy = function() {
  2334. return this.startMutedPolicy;
  2335. };
  2336. /**
  2337. * Check if audio is muted on join.
  2338. */
  2339. JitsiConference.prototype.isStartAudioMuted = function() {
  2340. return this.startAudioMuted;
  2341. };
  2342. /**
  2343. * Check if video is muted on join.
  2344. */
  2345. JitsiConference.prototype.isStartVideoMuted = function() {
  2346. return this.startVideoMuted;
  2347. };
  2348. /**
  2349. * Returns measured connectionTimes.
  2350. */
  2351. JitsiConference.prototype.getConnectionTimes = function() {
  2352. return this.room.connectionTimes;
  2353. };
  2354. /**
  2355. * Sets a property for the local participant.
  2356. */
  2357. JitsiConference.prototype.setLocalParticipantProperty = function(name, value) {
  2358. this.sendCommand(`jitsi_participant_${name}`, { value });
  2359. };
  2360. /**
  2361. * Removes a property for the local participant and sends the updated presence.
  2362. */
  2363. JitsiConference.prototype.removeLocalParticipantProperty = function(name) {
  2364. this.removeCommand(`jitsi_participant_${name}`);
  2365. this.room.sendPresence();
  2366. };
  2367. /**
  2368. * Gets a local participant property.
  2369. *
  2370. * @return value of the local participant property if the tagName exists in the
  2371. * list of properties, otherwise returns undefined.
  2372. */
  2373. JitsiConference.prototype.getLocalParticipantProperty = function(name) {
  2374. const property = this.room.presMap.nodes.find(prop =>
  2375. prop.tagName === `jitsi_participant_${name}`
  2376. );
  2377. return property ? property.value : undefined;
  2378. };
  2379. /**
  2380. * Sends the given feedback through CallStats if enabled.
  2381. *
  2382. * @param overallFeedback an integer between 1 and 5 indicating the
  2383. * user feedback
  2384. * @param detailedFeedback detailed feedback from the user. Not yet used
  2385. * @returns {Promise} Resolves if feedback is submitted successfully.
  2386. */
  2387. JitsiConference.prototype.sendFeedback = function(overallFeedback, detailedFeedback) {
  2388. return this.statistics.sendFeedback(overallFeedback, detailedFeedback);
  2389. };
  2390. /**
  2391. * Returns true if the callstats integration is enabled, otherwise returns
  2392. * false.
  2393. *
  2394. * @returns true if the callstats integration is enabled, otherwise returns
  2395. * false.
  2396. */
  2397. JitsiConference.prototype.isCallstatsEnabled = function() {
  2398. return this.statistics.isCallstatsEnabled();
  2399. };
  2400. /**
  2401. * Finds the SSRC of a given track
  2402. *
  2403. * @param track
  2404. * @returns {number|undefined} the SSRC of the specificed track, otherwise undefined.
  2405. */
  2406. JitsiConference.prototype.getSsrcByTrack = function(track) {
  2407. return track.isLocal() ? this.getActivePeerConnection()?.getLocalSSRC(track) : track.getSSRC();
  2408. };
  2409. /**
  2410. * Handles track attached to container (Calls associateStreamWithVideoTag method
  2411. * from statistics module)
  2412. * @param {JitsiLocalTrack|JitsiRemoteTrack} track the track
  2413. * @param container the container
  2414. */
  2415. JitsiConference.prototype._onTrackAttach = function(track, container) {
  2416. const isLocal = track.isLocal();
  2417. let ssrc = null;
  2418. const isP2P = track.isP2P;
  2419. const remoteUserId = isP2P ? track.getParticipantId() : 'jitsi';
  2420. const peerConnection
  2421. = isP2P
  2422. ? this.p2pJingleSession && this.p2pJingleSession.peerconnection
  2423. : this.jvbJingleSession && this.jvbJingleSession.peerconnection;
  2424. if (isLocal) {
  2425. // Local tracks have SSRC stored on per peer connection basis.
  2426. if (peerConnection) {
  2427. ssrc = peerConnection.getLocalSSRC(track);
  2428. }
  2429. } else {
  2430. ssrc = track.getSSRC();
  2431. }
  2432. if (!container.id || !ssrc || !peerConnection) {
  2433. return;
  2434. }
  2435. this.statistics.associateStreamWithVideoTag(
  2436. peerConnection,
  2437. ssrc,
  2438. isLocal,
  2439. remoteUserId,
  2440. track.getUsageLabel(),
  2441. container.id);
  2442. };
  2443. /**
  2444. * Logs an "application log" message.
  2445. * @param message {string} The message to log. Note that while this can be a
  2446. * generic string, the convention used by lib-jitsi-meet and jitsi-meet is to
  2447. * log valid JSON strings, with an "id" field used for distinguishing between
  2448. * message types. E.g.: {id: "recorder_status", status: "off"}
  2449. */
  2450. JitsiConference.prototype.sendApplicationLog = function(message) {
  2451. Statistics.sendLog(message);
  2452. };
  2453. /**
  2454. * Checks if the user identified by given <tt>mucJid</tt> is the conference focus.
  2455. * @param mucJid the full MUC address of the user to be checked.
  2456. * @returns {boolean|null} <tt>true</tt> if MUC user is the conference focus,
  2457. * <tt>false</tt> when is not. <tt>null</tt> if we're not in the MUC anymore and
  2458. * are unable to figure out the status or if given <tt>mucJid</tt> is invalid.
  2459. */
  2460. JitsiConference.prototype.isFocus = function(mucJid) {
  2461. return this.room ? this.room.isFocus(mucJid) : null;
  2462. };
  2463. /**
  2464. * Fires CONFERENCE_FAILED event with INCOMPATIBLE_SERVER_VERSIONS parameter
  2465. */
  2466. JitsiConference.prototype._fireIncompatibleVersionsEvent = function() {
  2467. this.eventEmitter.emit(JitsiConferenceEvents.CONFERENCE_FAILED,
  2468. JitsiConferenceErrors.INCOMPATIBLE_SERVER_VERSIONS);
  2469. };
  2470. /**
  2471. * Sends a message via the data channel.
  2472. * @param to {string} the id of the endpoint that should receive the message.
  2473. * If "" the message will be sent to all participants.
  2474. * @param payload {object} the payload of the message.
  2475. * @throws NetworkError or InvalidStateError or Error if the operation fails.
  2476. * @deprecated Use 'sendMessage' instead. TODO: this should be private.
  2477. */
  2478. JitsiConference.prototype.sendEndpointMessage = function(to, payload) {
  2479. this.rtc.sendChannelMessage(to, payload);
  2480. };
  2481. /**
  2482. * Sends local stats via the bridge channel which then forwards to other endpoints selectively.
  2483. * @param {Object} payload The payload of the message.
  2484. * @throws NetworkError/InvalidStateError/Error if the operation fails or if there is no data channel created.
  2485. */
  2486. JitsiConference.prototype.sendEndpointStatsMessage = function(payload) {
  2487. this.rtc.sendEndpointStatsMessage(payload);
  2488. };
  2489. /**
  2490. * Sends a broadcast message via the data channel.
  2491. * @param payload {object} the payload of the message.
  2492. * @throws NetworkError or InvalidStateError or Error if the operation fails.
  2493. * @deprecated Use 'sendMessage' instead. TODO: this should be private.
  2494. */
  2495. JitsiConference.prototype.broadcastEndpointMessage = function(payload) {
  2496. this.sendEndpointMessage('', payload);
  2497. };
  2498. /**
  2499. * Sends a message to a given endpoint (if 'to' is a non-empty string), or
  2500. * broadcasts it to all endpoints in the conference.
  2501. * @param {string} to The ID of the endpoint/participant which is to receive
  2502. * the message, or '' to broadcast the message to all endpoints in the
  2503. * conference.
  2504. * @param {string|object} message the message to send. If this is of type
  2505. * 'string' it will be sent as a chat message. If it is of type 'object', it
  2506. * will be encapsulated in a format recognized by jitsi-meet and converted to
  2507. * JSON before being sent.
  2508. * @param {boolean} sendThroughVideobridge Whether to send the message through
  2509. * jitsi-videobridge (via the COLIBRI data channel or web socket), or through
  2510. * the XMPP MUC. Currently only objects can be sent through jitsi-videobridge.
  2511. */
  2512. JitsiConference.prototype.sendMessage = function(message, to = '', sendThroughVideobridge = false) {
  2513. const messageType = typeof message;
  2514. // Through videobridge we support only objects. Through XMPP we support
  2515. // objects (encapsulated in a specific JSON format) and strings (i.e.
  2516. // regular chat messages).
  2517. if (messageType !== 'object'
  2518. && (sendThroughVideobridge || messageType !== 'string')) {
  2519. logger.error(`Can not send a message of type ${messageType}`);
  2520. return;
  2521. }
  2522. if (sendThroughVideobridge) {
  2523. this.sendEndpointMessage(to, message);
  2524. } else {
  2525. let messageToSend = message;
  2526. // Name of packet extension of message stanza to send the required
  2527. // message in.
  2528. let elementName = 'body';
  2529. if (messageType === 'object') {
  2530. elementName = 'json-message';
  2531. // Mark as valid JSON message if not already
  2532. if (!messageToSend.hasOwnProperty(JITSI_MEET_MUC_TYPE)) {
  2533. messageToSend[JITSI_MEET_MUC_TYPE] = '';
  2534. }
  2535. try {
  2536. messageToSend = JSON.stringify(messageToSend);
  2537. } catch (e) {
  2538. logger.error('Can not send a message, stringify failed: ', e);
  2539. return;
  2540. }
  2541. }
  2542. if (to) {
  2543. this.sendPrivateTextMessage(to, messageToSend, elementName);
  2544. } else {
  2545. // Broadcast
  2546. this.sendTextMessage(messageToSend, elementName);
  2547. }
  2548. }
  2549. };
  2550. JitsiConference.prototype.isConnectionInterrupted = function() {
  2551. return this.isP2PActive()
  2552. ? this.isP2PConnectionInterrupted : this.isJvbConnectionInterrupted;
  2553. };
  2554. /**
  2555. * Handles {@link XMPPEvents.CONNECTION_RESTARTED} event. This happens when the bridge goes down
  2556. * and Jicofo moves conferences away to a different bridge.
  2557. * @param {JingleSessionPC} session
  2558. * @private
  2559. */
  2560. JitsiConference.prototype._onConferenceRestarted = function(session) {
  2561. if (!session.isP2P && this.options.config.enableForcedReload) {
  2562. this.eventEmitter.emit(JitsiConferenceEvents.CONFERENCE_FAILED, JitsiConferenceErrors.CONFERENCE_RESTARTED);
  2563. }
  2564. };
  2565. /**
  2566. * Handles {@link XMPPEvents.CONNECTION_INTERRUPTED}
  2567. * @param {JingleSessionPC} session
  2568. * @private
  2569. */
  2570. JitsiConference.prototype._onIceConnectionInterrupted = function(session) {
  2571. if (session.isP2P) {
  2572. this.isP2PConnectionInterrupted = true;
  2573. } else {
  2574. this.isJvbConnectionInterrupted = true;
  2575. }
  2576. if (session.isP2P === this.isP2PActive()) {
  2577. this.eventEmitter.emit(JitsiConferenceEvents.CONNECTION_INTERRUPTED);
  2578. }
  2579. };
  2580. /**
  2581. * Handles {@link XMPPEvents.CONNECTION_ICE_FAILED}
  2582. * @param {JingleSessionPC} session
  2583. * @private
  2584. */
  2585. JitsiConference.prototype._onIceConnectionFailed = function(session) {
  2586. // We do nothing for the JVB connection, because it's up to the Jicofo to
  2587. // eventually come up with the new offer (at least for the time being).
  2588. if (session.isP2P) {
  2589. // Add p2pFailed property to analytics to distinguish, between "good"
  2590. // and "bad" connection
  2591. Statistics.analytics.addPermanentProperties({ p2pFailed: true });
  2592. if (this.p2pJingleSession) {
  2593. Statistics.sendAnalyticsAndLog(
  2594. createP2PEvent(
  2595. ACTION_P2P_FAILED,
  2596. {
  2597. initiator: this.p2pJingleSession.isInitiator
  2598. }));
  2599. }
  2600. this._stopP2PSession({
  2601. reason: 'connectivity-error',
  2602. reasonDescription: 'ICE FAILED'
  2603. });
  2604. } else if (session && this.jvbJingleSession === session) {
  2605. this._delayedIceFailed = new IceFailedHandling(this);
  2606. this._delayedIceFailed.start(session);
  2607. }
  2608. };
  2609. /**
  2610. * Handles {@link XMPPEvents.CONNECTION_RESTORED}
  2611. * @param {JingleSessionPC} session
  2612. * @private
  2613. */
  2614. JitsiConference.prototype._onIceConnectionRestored = function(session) {
  2615. if (session.isP2P) {
  2616. this.isP2PConnectionInterrupted = false;
  2617. } else {
  2618. this.isJvbConnectionInterrupted = false;
  2619. this._delayedIceFailed && this._delayedIceFailed.cancel();
  2620. }
  2621. if (session.isP2P === this.isP2PActive()) {
  2622. this.eventEmitter.emit(JitsiConferenceEvents.CONNECTION_RESTORED);
  2623. }
  2624. };
  2625. /**
  2626. * Accept incoming P2P Jingle call.
  2627. * @param {JingleSessionPC} jingleSession the session instance
  2628. * @param {jQuery} jingleOffer a jQuery selector pointing to 'jingle' IQ element
  2629. * @private
  2630. */
  2631. JitsiConference.prototype._acceptP2PIncomingCall = function(jingleSession, jingleOffer) {
  2632. this.isP2PConnectionInterrupted = false;
  2633. // Accept the offer
  2634. this.p2pJingleSession = jingleSession;
  2635. this._sendConferenceJoinAnalyticsEvent();
  2636. this.p2pJingleSession.initialize(
  2637. this.room,
  2638. this.rtc,
  2639. this._signalingLayer,
  2640. {
  2641. ...this.options.config,
  2642. enableInsertableStreams: this.isE2EEEnabled()
  2643. });
  2644. logger.info('Starting CallStats for P2P connection...');
  2645. let remoteID = Strophe.getResourceFromJid(this.p2pJingleSession.remoteJid);
  2646. const participant = this.participants[remoteID];
  2647. if (participant) {
  2648. remoteID = participant.getStatsID() || remoteID;
  2649. }
  2650. this.statistics.startCallStats(
  2651. this.p2pJingleSession.peerconnection,
  2652. remoteID);
  2653. const localTracks = this.getLocalTracks();
  2654. this.p2pJingleSession.acceptOffer(
  2655. jingleOffer,
  2656. () => {
  2657. logger.debug('Got RESULT for P2P "session-accept"');
  2658. this.eventEmitter.emit(
  2659. JitsiConferenceEvents._MEDIA_SESSION_STARTED,
  2660. jingleSession);
  2661. },
  2662. error => {
  2663. logger.error(
  2664. 'Failed to accept incoming P2P Jingle session', error);
  2665. },
  2666. localTracks);
  2667. };
  2668. /**
  2669. * Adds remote tracks to the conference associated with the JVB session.
  2670. * @private
  2671. */
  2672. JitsiConference.prototype._addRemoteJVBTracks = function() {
  2673. this._addRemoteTracks('JVB', this.jvbJingleSession.peerconnection.getRemoteTracks());
  2674. };
  2675. /**
  2676. * Adds remote tracks to the conference associated with the P2P session.
  2677. * @private
  2678. */
  2679. JitsiConference.prototype._addRemoteP2PTracks = function() {
  2680. this._addRemoteTracks('P2P', this.p2pJingleSession.peerconnection.getRemoteTracks());
  2681. };
  2682. /**
  2683. * Generates fake "remote track added" events for given Jingle session.
  2684. * @param {string} logName the session's nickname which will appear in log
  2685. * messages.
  2686. * @param {Array<JitsiRemoteTrack>} remoteTracks the tracks that will be added
  2687. * @private
  2688. */
  2689. JitsiConference.prototype._addRemoteTracks = function(logName, remoteTracks) {
  2690. for (const track of remoteTracks) {
  2691. logger.info(`Adding remote ${logName} track: ${track}`);
  2692. this.onRemoteTrackAdded(track);
  2693. }
  2694. };
  2695. /**
  2696. * Called when {@link XMPPEvents.CONNECTION_ESTABLISHED} event is
  2697. * triggered for a {@link JingleSessionPC}. Switches the conference to use
  2698. * the P2P connection if the event comes from the P2P session.
  2699. * @param {JingleSessionPC} jingleSession the session instance.
  2700. * @private
  2701. */
  2702. JitsiConference.prototype._onIceConnectionEstablished = function(jingleSession) {
  2703. if (this.p2pJingleSession !== null) {
  2704. // store the establishment time of the p2p session as a field of the
  2705. // JitsiConference because the p2pJingleSession might get disposed (thus
  2706. // the value is lost).
  2707. this.p2pEstablishmentDuration
  2708. = this.p2pJingleSession.establishmentDuration;
  2709. }
  2710. if (this.jvbJingleSession !== null) {
  2711. this.jvbEstablishmentDuration
  2712. = this.jvbJingleSession.establishmentDuration;
  2713. }
  2714. let done = false;
  2715. const forceJVB121Ratio = this.options.config.forceJVB121Ratio;
  2716. // We don't care about the JVB case, there's nothing to be done
  2717. if (!jingleSession.isP2P) {
  2718. done = true;
  2719. } else if (this.p2pJingleSession !== jingleSession) {
  2720. logger.error('CONNECTION_ESTABLISHED - wrong P2P session instance ?!');
  2721. done = true;
  2722. } else if (!jingleSession.isInitiator
  2723. && typeof forceJVB121Ratio === 'number'
  2724. && Math.random() < forceJVB121Ratio) {
  2725. logger.info(`Forcing JVB 121 mode (ratio=${forceJVB121Ratio})...`);
  2726. Statistics.analytics.addPermanentProperties({ forceJvb121: true });
  2727. this._stopP2PSession({
  2728. reason: 'decline',
  2729. reasonDescription: 'force JVB121'
  2730. });
  2731. done = true;
  2732. }
  2733. if (!isNaN(this.p2pEstablishmentDuration)
  2734. && !isNaN(this.jvbEstablishmentDuration)) {
  2735. const establishmentDurationDiff
  2736. = this.p2pEstablishmentDuration - this.jvbEstablishmentDuration;
  2737. Statistics.sendAnalytics(
  2738. ICE_ESTABLISHMENT_DURATION_DIFF,
  2739. { value: establishmentDurationDiff });
  2740. }
  2741. if (jingleSession.isP2P === this.isP2PActive()) {
  2742. this.eventEmitter.emit(JitsiConferenceEvents.CONNECTION_ESTABLISHED);
  2743. }
  2744. if (done) {
  2745. return;
  2746. }
  2747. // Update P2P status and emit events
  2748. this._setP2PStatus(true);
  2749. // Remove remote tracks
  2750. if (this.jvbJingleSession) {
  2751. this._removeRemoteJVBTracks();
  2752. } else {
  2753. logger.info('Not removing remote JVB tracks - no session yet');
  2754. }
  2755. this._addRemoteP2PTracks();
  2756. // Stop media transfer over the JVB connection
  2757. if (this.jvbJingleSession) {
  2758. this._suspendMediaTransferForJvbConnection();
  2759. }
  2760. logger.info('Starting remote stats with p2p connection');
  2761. this.statistics.startRemoteStats(this.p2pJingleSession.peerconnection);
  2762. Statistics.sendAnalyticsAndLog(
  2763. createP2PEvent(
  2764. ACTION_P2P_ESTABLISHED,
  2765. {
  2766. initiator: this.p2pJingleSession.isInitiator
  2767. }));
  2768. };
  2769. /**
  2770. * Called when the chat room reads a new list of properties from jicofo's
  2771. * presence. The properties may have changed, but they don't have to.
  2772. *
  2773. * @param {Object} properties - The properties keyed by the property name
  2774. * ('key').
  2775. * @private
  2776. */
  2777. JitsiConference.prototype._updateProperties = function(properties = {}) {
  2778. const changed = !isEqual(properties, this.properties);
  2779. this.properties = properties;
  2780. if (changed) {
  2781. this.eventEmitter.emit(JitsiConferenceEvents.PROPERTIES_CHANGED, this.properties);
  2782. const audioLimitReached = this.properties['audio-limit-reached'] === 'true';
  2783. const videoLimitReached = this.properties['video-limit-reached'] === 'true';
  2784. if (this._audioSenderLimitReached !== audioLimitReached) {
  2785. this._audioSenderLimitReached = audioLimitReached;
  2786. this.eventEmitter.emit(JitsiConferenceEvents.AUDIO_UNMUTE_PERMISSIONS_CHANGED, audioLimitReached);
  2787. logger.info(`Audio unmute permissions set by Jicofo to ${audioLimitReached}`);
  2788. }
  2789. if (this._videoSenderLimitReached !== videoLimitReached) {
  2790. this._videoSenderLimitReached = videoLimitReached;
  2791. this.eventEmitter.emit(JitsiConferenceEvents.VIDEO_UNMUTE_PERMISSIONS_CHANGED, videoLimitReached);
  2792. logger.info(`Video unmute permissions set by Jicofo to ${videoLimitReached}`);
  2793. }
  2794. // Some of the properties need to be added to analytics events.
  2795. const analyticsKeys = [
  2796. // The number of jitsi-videobridge instances currently used for the
  2797. // conference.
  2798. 'bridge-count',
  2799. // The conference creation time (set by jicofo).
  2800. 'created-ms'
  2801. ];
  2802. analyticsKeys.forEach(key => {
  2803. if (properties[key] !== undefined) {
  2804. Statistics.analytics.addPermanentProperties({
  2805. [key.replace('-', '_')]: properties[key]
  2806. });
  2807. }
  2808. });
  2809. }
  2810. };
  2811. /**
  2812. * Gets a conference property with a given key.
  2813. *
  2814. * @param {string} key - The key.
  2815. * @returns {*} The value
  2816. */
  2817. JitsiConference.prototype.getProperty = function(key) {
  2818. return this.properties[key];
  2819. };
  2820. /**
  2821. * Clears the deferred start P2P task if it has been scheduled.
  2822. * @private
  2823. */
  2824. JitsiConference.prototype._maybeClearDeferredStartP2P = function() {
  2825. if (this.deferredStartP2PTask) {
  2826. logger.info('Cleared deferred start P2P task');
  2827. clearTimeout(this.deferredStartP2PTask);
  2828. this.deferredStartP2PTask = null;
  2829. }
  2830. };
  2831. /**
  2832. * Removes from the conference remote tracks associated with the JVB
  2833. * connection.
  2834. * @private
  2835. */
  2836. JitsiConference.prototype._removeRemoteJVBTracks = function() {
  2837. this._removeRemoteTracks(
  2838. 'JVB', this.jvbJingleSession.peerconnection.getRemoteTracks());
  2839. };
  2840. /**
  2841. * Removes from the conference remote tracks associated with the P2P
  2842. * connection.
  2843. * @private
  2844. */
  2845. JitsiConference.prototype._removeRemoteP2PTracks = function() {
  2846. this._removeRemoteTracks(
  2847. 'P2P', this.p2pJingleSession.peerconnection.getRemoteTracks());
  2848. };
  2849. /**
  2850. * Generates fake "remote track removed" events for given Jingle session.
  2851. * @param {string} sessionNickname the session's nickname which will appear in
  2852. * log messages.
  2853. * @param {Array<JitsiRemoteTrack>} remoteTracks the tracks that will be removed
  2854. * @private
  2855. */
  2856. JitsiConference.prototype._removeRemoteTracks = function(sessionNickname, remoteTracks) {
  2857. for (const track of remoteTracks) {
  2858. logger.info(`Removing remote ${sessionNickname} track: ${track}`);
  2859. this.onRemoteTrackRemoved(track);
  2860. }
  2861. };
  2862. /**
  2863. * Resumes media transfer over the JVB connection.
  2864. * @private
  2865. */
  2866. JitsiConference.prototype._resumeMediaTransferForJvbConnection = function() {
  2867. logger.info('Resuming media transfer over the JVB connection...');
  2868. this.jvbJingleSession.setMediaTransferActive(true, true).then(
  2869. () => {
  2870. logger.info('Resumed media transfer over the JVB connection!');
  2871. },
  2872. error => {
  2873. logger.error(
  2874. 'Failed to resume media transfer over the JVB connection:',
  2875. error);
  2876. });
  2877. };
  2878. /**
  2879. * Sets new P2P status and updates some events/states hijacked from
  2880. * the <tt>JitsiConference</tt>.
  2881. * @param {boolean} newStatus the new P2P status value, <tt>true</tt> means that
  2882. * P2P is now in use, <tt>false</tt> means that the JVB connection is now in use
  2883. * @private
  2884. */
  2885. JitsiConference.prototype._setP2PStatus = function(newStatus) {
  2886. if (this.p2p === newStatus) {
  2887. logger.debug(`Called _setP2PStatus with the same status: ${newStatus}`);
  2888. return;
  2889. }
  2890. this.p2p = newStatus;
  2891. if (newStatus) {
  2892. logger.info('Peer to peer connection established!');
  2893. // When we end up in a valid P2P session need to reset the properties
  2894. // in case they have persisted, after session with another peer.
  2895. Statistics.analytics.addPermanentProperties({
  2896. p2pFailed: false,
  2897. forceJvb121: false
  2898. });
  2899. // Sync up video transfer active in case p2pJingleSession not existed
  2900. // when the lastN value was being adjusted.
  2901. const isVideoActive = this.getLastN() !== 0;
  2902. this.p2pJingleSession
  2903. .setMediaTransferActive(true, isVideoActive)
  2904. .catch(error => {
  2905. logger.error(
  2906. 'Failed to sync up P2P video transfer status'
  2907. + `(${isVideoActive})`, error);
  2908. });
  2909. } else {
  2910. logger.info('Peer to peer connection closed!');
  2911. }
  2912. // Put the JVB connection on hold/resume
  2913. if (this.jvbJingleSession) {
  2914. this.statistics.sendConnectionResumeOrHoldEvent(
  2915. this.jvbJingleSession.peerconnection, !newStatus);
  2916. }
  2917. // Clear dtmfManager, so that it can be recreated with new connection
  2918. this.dtmfManager = null;
  2919. // Update P2P status
  2920. this.eventEmitter.emit(
  2921. JitsiConferenceEvents.P2P_STATUS,
  2922. this,
  2923. this.p2p);
  2924. this.eventEmitter.emit(JitsiConferenceEvents._MEDIA_SESSION_ACTIVE_CHANGED, this.getActiveMediaSession());
  2925. // Refresh connection interrupted/restored
  2926. this.eventEmitter.emit(
  2927. this.isConnectionInterrupted()
  2928. ? JitsiConferenceEvents.CONNECTION_INTERRUPTED
  2929. : JitsiConferenceEvents.CONNECTION_RESTORED);
  2930. };
  2931. /**
  2932. * Starts new P2P session.
  2933. * @param {string} remoteJid the JID of the remote participant
  2934. * @private
  2935. */
  2936. JitsiConference.prototype._startP2PSession = function(remoteJid) {
  2937. this._maybeClearDeferredStartP2P();
  2938. if (this.p2pJingleSession) {
  2939. logger.error('P2P session already started!');
  2940. return;
  2941. }
  2942. this.isP2PConnectionInterrupted = false;
  2943. this.p2pJingleSession
  2944. = this.xmpp.connection.jingle.newP2PJingleSession(
  2945. this.room.myroomjid,
  2946. remoteJid);
  2947. logger.info(
  2948. 'Created new P2P JingleSession', this.room.myroomjid, remoteJid);
  2949. this._sendConferenceJoinAnalyticsEvent();
  2950. this.p2pJingleSession.initialize(
  2951. this.room,
  2952. this.rtc,
  2953. this._signalingLayer,
  2954. {
  2955. ...this.options.config,
  2956. enableInsertableStreams: this.isE2EEEnabled()
  2957. });
  2958. logger.info('Starting CallStats for P2P connection...');
  2959. let remoteID = Strophe.getResourceFromJid(this.p2pJingleSession.remoteJid);
  2960. const participant = this.participants[remoteID];
  2961. if (participant) {
  2962. remoteID = participant.getStatsID() || remoteID;
  2963. }
  2964. this.statistics.startCallStats(
  2965. this.p2pJingleSession.peerconnection,
  2966. remoteID);
  2967. const localTracks = this.getLocalTracks();
  2968. this.p2pJingleSession.invite(localTracks);
  2969. };
  2970. /**
  2971. * Suspends media transfer over the JVB connection.
  2972. * @private
  2973. */
  2974. JitsiConference.prototype._suspendMediaTransferForJvbConnection = function() {
  2975. logger.info('Suspending media transfer over the JVB connection...');
  2976. this.jvbJingleSession.setMediaTransferActive(false, false).then(
  2977. () => {
  2978. logger.info('Suspended media transfer over the JVB connection !');
  2979. },
  2980. error => {
  2981. logger.error(
  2982. 'Failed to suspend media transfer over the JVB connection:',
  2983. error);
  2984. });
  2985. };
  2986. /**
  2987. * Method when called will decide whether it's the time to start or stop
  2988. * the P2P session.
  2989. * @param {boolean} userLeftEvent if <tt>true</tt> it means that the call
  2990. * originates from the user left event.
  2991. * @private
  2992. */
  2993. JitsiConference.prototype._maybeStartOrStopP2P = function(userLeftEvent) {
  2994. if (!this.isP2PEnabled()
  2995. || this.isP2PTestModeEnabled()
  2996. || browser.isFirefox()
  2997. || browser.isWebKitBased()
  2998. || this.isE2EEEnabled()) {
  2999. logger.info('Auto P2P disabled');
  3000. return;
  3001. }
  3002. const peers = this.getParticipants();
  3003. const peerCount = peers.length;
  3004. // FIXME 1 peer and it must *support* P2P switching
  3005. const shouldBeInP2P = this._shouldBeInP2PMode();
  3006. // Clear deferred "start P2P" task
  3007. if (!shouldBeInP2P && this.deferredStartP2PTask) {
  3008. this._maybeClearDeferredStartP2P();
  3009. }
  3010. // Start peer to peer session
  3011. if (!this.p2pJingleSession && shouldBeInP2P) {
  3012. const peer = peerCount && peers[0];
  3013. const myId = this.myUserId();
  3014. const peersId = peer.getId();
  3015. if (myId > peersId) {
  3016. logger.debug(
  3017. 'I\'m the bigger peersId - '
  3018. + 'the other peer should start P2P', myId, peersId);
  3019. return;
  3020. } else if (myId === peersId) {
  3021. logger.error('The same IDs ? ', myId, peersId);
  3022. return;
  3023. }
  3024. const jid = peer.getJid();
  3025. if (userLeftEvent) {
  3026. if (this.deferredStartP2PTask) {
  3027. logger.error('Deferred start P2P task\'s been set already!');
  3028. return;
  3029. }
  3030. logger.info(
  3031. `Will start P2P with: ${jid} after ${
  3032. this.backToP2PDelay} seconds...`);
  3033. this.deferredStartP2PTask = setTimeout(
  3034. this._startP2PSession.bind(this, jid),
  3035. this.backToP2PDelay * 1000);
  3036. } else {
  3037. logger.info(`Will start P2P with: ${jid}`);
  3038. this._startP2PSession(jid);
  3039. }
  3040. } else if (this.p2pJingleSession && !shouldBeInP2P) {
  3041. logger.info(`Will stop P2P with: ${this.p2pJingleSession.remoteJid}`);
  3042. // Log that there will be a switch back to the JVB connection
  3043. if (this.p2pJingleSession.isInitiator && peerCount > 1) {
  3044. Statistics.sendAnalyticsAndLog(
  3045. createP2PEvent(ACTION_P2P_SWITCH_TO_JVB));
  3046. }
  3047. this._stopP2PSession();
  3048. }
  3049. };
  3050. /**
  3051. * Tells whether or not this conference should be currently in the P2P mode.
  3052. *
  3053. * @private
  3054. * @returns {boolean}
  3055. */
  3056. JitsiConference.prototype._shouldBeInP2PMode = function() {
  3057. const peers = this.getParticipants();
  3058. const peerCount = peers.length;
  3059. const hasBotPeer = peers.find(p => p.getBotType() === 'poltergeist' || p.hasFeature(FEATURE_JIGASI)) !== undefined;
  3060. const shouldBeInP2P = peerCount === 1 && !hasBotPeer;
  3061. logger.debug(`P2P? peerCount: ${peerCount}, hasBotPeer: ${hasBotPeer} => ${shouldBeInP2P}`);
  3062. return shouldBeInP2P;
  3063. };
  3064. /**
  3065. * Stops the current P2P session.
  3066. * @param {Object} options - Options for stopping P2P.
  3067. * @param {string} options.reason - One of the Jingle "reason" element
  3068. * names as defined by https://xmpp.org/extensions/xep-0166.html#def-reason
  3069. * @param {string} options.reasonDescription - Text
  3070. * description that will be included in the session terminate message
  3071. * @param {boolean} requestRestart - Whether this is due to a session restart, in which case
  3072. * media will not be resumed on the JVB.
  3073. * @private
  3074. */
  3075. JitsiConference.prototype._stopP2PSession = function(options = {}) {
  3076. const {
  3077. reason = 'success',
  3078. reasonDescription = 'Turning off P2P session',
  3079. requestRestart = false
  3080. } = options;
  3081. if (!this.p2pJingleSession) {
  3082. logger.error('No P2P session to be stopped!');
  3083. return;
  3084. }
  3085. const wasP2PEstablished = this.isP2PActive();
  3086. // Swap remote tracks, but only if the P2P has been fully established
  3087. if (wasP2PEstablished) {
  3088. if (this.jvbJingleSession && !requestRestart) {
  3089. this._resumeMediaTransferForJvbConnection();
  3090. }
  3091. // Remove remote P2P tracks
  3092. this._removeRemoteP2PTracks();
  3093. }
  3094. // Stop P2P stats
  3095. logger.info('Stopping remote stats for P2P connection');
  3096. this.statistics.stopRemoteStats(this.p2pJingleSession.peerconnection);
  3097. logger.info('Stopping CallStats for P2P connection');
  3098. this.statistics.stopCallStats(this.p2pJingleSession.peerconnection);
  3099. this.p2pJingleSession.terminate(
  3100. () => {
  3101. logger.info('P2P session terminate RESULT');
  3102. },
  3103. error => {
  3104. // Because both initiator and responder are simultaneously
  3105. // terminating their JingleSessions in case of the 'to JVB switch'
  3106. // when 3rd participant joins, both will dispose their sessions and
  3107. // reply with 'item-not-found' (see strophe.jingle.js). We don't
  3108. // want to log this as an error since it's expected behaviour.
  3109. //
  3110. // We want them both to terminate, because in case of initiator's
  3111. // crash the responder would stay in P2P mode until ICE fails which
  3112. // could take up to 20 seconds.
  3113. //
  3114. // NOTE: whilst this is an error callback, 'success' as a reason is
  3115. // considered as graceful session terminate
  3116. // where both initiator and responder terminate their sessions
  3117. // simultaneously.
  3118. if (reason !== 'success') {
  3119. logger.error('An error occurred while trying to terminate P2P Jingle session', error);
  3120. }
  3121. }, {
  3122. reason,
  3123. reasonDescription,
  3124. sendSessionTerminate: this.room
  3125. && this.getParticipantById(
  3126. Strophe.getResourceFromJid(this.p2pJingleSession.remoteJid))
  3127. });
  3128. this.p2pJingleSession = null;
  3129. // Update P2P status and other affected events/states
  3130. this._setP2PStatus(false);
  3131. if (wasP2PEstablished) {
  3132. // Add back remote JVB tracks
  3133. if (this.jvbJingleSession && !requestRestart) {
  3134. this._addRemoteJVBTracks();
  3135. } else {
  3136. logger.info('Not adding remote JVB tracks - no session yet');
  3137. }
  3138. }
  3139. };
  3140. /**
  3141. * Updates room presence if needed and send the packet in case of a modification.
  3142. * @param {JingleSessionPC} jingleSession the session firing the event, contains the peer connection which
  3143. * tracks we will check.
  3144. * @param {Object|null} ctx a context object we can distinguish multiple calls of the same pass of updating tracks.
  3145. */
  3146. JitsiConference.prototype._updateRoomPresence = function(jingleSession, ctx) {
  3147. if (!jingleSession) {
  3148. return;
  3149. }
  3150. // skips sending presence twice for the same pass of updating ssrcs
  3151. if (ctx) {
  3152. if (ctx.skip) {
  3153. return;
  3154. }
  3155. ctx.skip = true;
  3156. }
  3157. let presenceChanged = false;
  3158. let muteStatusChanged, videoTypeChanged;
  3159. const localTracks = jingleSession.peerconnection.getLocalTracks();
  3160. const localAudioTracks = localTracks.filter(track => track.getType() === MediaType.AUDIO);
  3161. const localVideoTracks = localTracks.filter(track => track.getType() === MediaType.VIDEO);
  3162. // Set presence for all the available local tracks.
  3163. for (const track of localTracks) {
  3164. muteStatusChanged = this._setTrackMuteStatus(track.getType(), track, track.isMuted());
  3165. if (track.getType() === MediaType.VIDEO) {
  3166. videoTypeChanged = this._setNewVideoType(track);
  3167. }
  3168. presenceChanged = presenceChanged || muteStatusChanged || videoTypeChanged;
  3169. }
  3170. // Set the presence in the legacy format if there are no local tracks and multi stream support is not enabled.
  3171. if (!FeatureFlags.isMultiStreamSupportEnabled()) {
  3172. let audioMuteStatusChanged, videoMuteStatusChanged;
  3173. if (!localAudioTracks?.length) {
  3174. audioMuteStatusChanged = this._setTrackMuteStatus(MediaType.AUDIO, undefined, true);
  3175. }
  3176. if (!localVideoTracks?.length) {
  3177. videoMuteStatusChanged = this._setTrackMuteStatus(MediaType.VIDEO, undefined, true);
  3178. videoTypeChanged = this._setNewVideoType();
  3179. }
  3180. presenceChanged = presenceChanged || audioMuteStatusChanged || videoMuteStatusChanged || videoTypeChanged;
  3181. }
  3182. presenceChanged && this.room.sendPresence();
  3183. };
  3184. /**
  3185. * Checks whether or not the conference is currently in the peer to peer mode.
  3186. * Being in peer to peer mode means that the direct connection has been
  3187. * established and the P2P connection is being used for media transmission.
  3188. * @return {boolean} <tt>true</tt> if in P2P mode or <tt>false</tt> otherwise.
  3189. */
  3190. JitsiConference.prototype.isP2PActive = function() {
  3191. return this.p2p;
  3192. };
  3193. /**
  3194. * Returns the current ICE state of the P2P connection.
  3195. * NOTE: method is used by the jitsi-meet-torture tests.
  3196. * @return {string|null} an ICE state or <tt>null</tt> if there's currently
  3197. * no P2P connection.
  3198. */
  3199. JitsiConference.prototype.getP2PConnectionState = function() {
  3200. if (this.isP2PActive()) {
  3201. return this.p2pJingleSession.peerconnection.getConnectionState();
  3202. }
  3203. return null;
  3204. };
  3205. /**
  3206. * Configures the peerconnection so that a given framre rate can be achieved for desktop share.
  3207. *
  3208. * @param {number} maxFps The capture framerate to be used for desktop tracks.
  3209. * @returns {boolean} true if the operation is successful, false otherwise.
  3210. */
  3211. JitsiConference.prototype.setDesktopSharingFrameRate = function(maxFps) {
  3212. if (typeof maxFps !== 'number' || isNaN(maxFps)) {
  3213. logger.error(`Invalid value ${maxFps} specified for desktop capture frame rate`);
  3214. return false;
  3215. }
  3216. this._desktopSharingFrameRate = maxFps;
  3217. // Enable or disable simulcast for plan-b screensharing based on the capture fps.
  3218. this.jvbJingleSession && this.jvbJingleSession.peerconnection.setDesktopSharingFrameRate(maxFps);
  3219. // Set the capture rate for desktop sharing.
  3220. this.rtc.setDesktopSharingFrameRate(maxFps);
  3221. return true;
  3222. };
  3223. /**
  3224. * Manually starts new P2P session (should be used only in the tests).
  3225. */
  3226. JitsiConference.prototype.startP2PSession = function() {
  3227. const peers = this.getParticipants();
  3228. // Start peer to peer session
  3229. if (peers.length === 1) {
  3230. const peerJid = peers[0].getJid();
  3231. this._startP2PSession(peerJid);
  3232. } else {
  3233. throw new Error(
  3234. 'There must be exactly 1 participant to start the P2P session !');
  3235. }
  3236. };
  3237. /**
  3238. * Manually stops the current P2P session (should be used only in the tests).
  3239. */
  3240. JitsiConference.prototype.stopP2PSession = function(options) {
  3241. this._stopP2PSession(options);
  3242. };
  3243. /**
  3244. * Get a summary of how long current participants have been the dominant speaker
  3245. * @returns {object}
  3246. */
  3247. JitsiConference.prototype.getSpeakerStats = function() {
  3248. return this.speakerStatsCollector.getStats();
  3249. };
  3250. /**
  3251. * Sends a face landmarks object to the xmpp server.
  3252. * @param {Object} payload
  3253. */
  3254. JitsiConference.prototype.sendFaceLandmarks = function(payload) {
  3255. if (payload.faceExpression) {
  3256. this.xmpp.sendFaceExpressionEvent(this.room.roomjid, payload);
  3257. }
  3258. };
  3259. /**
  3260. * Sets the constraints for the video that is requested from the bridge.
  3261. *
  3262. * @param {Object} videoConstraints The constraints which are specified in the
  3263. * following format. The message updates the fields that are present and leaves the
  3264. * rest unchanged on the bridge. Therefore, any field that is not applicable anymore
  3265. * should be cleared by passing an empty object or list (whatever is applicable).
  3266. * {
  3267. * 'lastN': 20,
  3268. * 'selectedEndpoints': ['A', 'B', 'C'],
  3269. * 'onStageEndpoints': ['A'],
  3270. * 'defaultConstraints': { 'maxHeight': 180 },
  3271. * 'constraints': {
  3272. * 'A': { 'maxHeight': 720 }
  3273. * }
  3274. * }
  3275. */
  3276. JitsiConference.prototype.setReceiverConstraints = function(videoConstraints) {
  3277. this.receiveVideoController.setReceiverConstraints(videoConstraints);
  3278. };
  3279. /**
  3280. * Sets the maximum video size the local participant should receive from remote
  3281. * participants.
  3282. *
  3283. * @param {number} maxFrameHeight - the maximum frame height, in pixels,
  3284. * this receiver is willing to receive.
  3285. * @returns {void}
  3286. */
  3287. JitsiConference.prototype.setReceiverVideoConstraint = function(maxFrameHeight) {
  3288. this.receiveVideoController.setPreferredReceiveMaxFrameHeight(maxFrameHeight);
  3289. };
  3290. /**
  3291. * Sets the maximum video size the local participant should send to remote
  3292. * participants.
  3293. * @param {number} maxFrameHeight - The user preferred max frame height.
  3294. * @returns {Promise} promise that will be resolved when the operation is
  3295. * successful and rejected otherwise.
  3296. */
  3297. JitsiConference.prototype.setSenderVideoConstraint = function(maxFrameHeight) {
  3298. return this.sendVideoController.setPreferredSendMaxFrameHeight(maxFrameHeight);
  3299. };
  3300. /**
  3301. * Creates a video SIP GW session and returns it if service is enabled. Before
  3302. * creating a session one need to check whether video SIP GW service is
  3303. * available in the system {@link JitsiConference.isVideoSIPGWAvailable}. Even
  3304. * if there are available nodes to serve this request, after creating the
  3305. * session those nodes can be taken and the request about using the
  3306. * created session can fail.
  3307. *
  3308. * @param {string} sipAddress - The sip address to be used.
  3309. * @param {string} displayName - The display name to be used for this session.
  3310. * @returns {JitsiVideoSIPGWSession|Error} Returns null if conference is not
  3311. * initialised and there is no room.
  3312. */
  3313. JitsiConference.prototype.createVideoSIPGWSession = function(sipAddress, displayName) {
  3314. if (!this.room) {
  3315. return new Error(VideoSIPGWConstants.ERROR_NO_CONNECTION);
  3316. }
  3317. return this.videoSIPGWHandler
  3318. .createVideoSIPGWSession(sipAddress, displayName);
  3319. };
  3320. /**
  3321. * Sends a conference.join analytics event.
  3322. *
  3323. * @returns {void}
  3324. */
  3325. JitsiConference.prototype._sendConferenceJoinAnalyticsEvent = function() {
  3326. const meetingId = this.getMeetingUniqueId();
  3327. if (this._conferenceJoinAnalyticsEventSent || !meetingId || this.getActivePeerConnection() === null) {
  3328. return;
  3329. }
  3330. Statistics.sendAnalytics(createConferenceEvent('joined', {
  3331. meetingId,
  3332. participantId: `${meetingId}.${this._statsCurrentId}`
  3333. }));
  3334. this._conferenceJoinAnalyticsEventSent = Date.now();
  3335. };
  3336. /**
  3337. * Sends conference.left analytics event.
  3338. * @private
  3339. */
  3340. JitsiConference.prototype._sendConferenceLeftAnalyticsEvent = function() {
  3341. const meetingId = this.getMeetingUniqueId();
  3342. if (!meetingId || !this._conferenceJoinAnalyticsEventSent) {
  3343. return;
  3344. }
  3345. Statistics.sendAnalytics(createConferenceEvent('left', {
  3346. meetingId,
  3347. participantId: `${meetingId}.${this._statsCurrentId}`,
  3348. stats: {
  3349. duration: Math.floor((Date.now() - this._conferenceJoinAnalyticsEventSent) / 1000),
  3350. perf: this.getPerformanceStats()
  3351. }
  3352. }));
  3353. };
  3354. /**
  3355. * Restarts all active media sessions.
  3356. *
  3357. * @returns {void}
  3358. */
  3359. JitsiConference.prototype._restartMediaSessions = function() {
  3360. if (this.p2pJingleSession) {
  3361. this._stopP2PSession({
  3362. reasonDescription: 'restart',
  3363. requestRestart: true
  3364. });
  3365. }
  3366. if (this.jvbJingleSession) {
  3367. this.jvbJingleSession.terminate(
  3368. null /* success callback => we don't care */,
  3369. error => {
  3370. logger.warn('An error occurred while trying to terminate the JVB session', error);
  3371. }, {
  3372. reason: 'success',
  3373. reasonDescription: 'restart required',
  3374. requestRestart: true,
  3375. sendSessionTerminate: true
  3376. });
  3377. }
  3378. this._maybeStartOrStopP2P(false);
  3379. };
  3380. /**
  3381. * Returns whether End-To-End encryption is enabled.
  3382. *
  3383. * @returns {boolean}
  3384. */
  3385. JitsiConference.prototype.isE2EEEnabled = function() {
  3386. return Boolean(this._e2eEncryption && this._e2eEncryption.isEnabled());
  3387. };
  3388. /**
  3389. * Returns whether End-To-End encryption is supported. Note that not all participants
  3390. * in the conference may support it.
  3391. *
  3392. * @returns {boolean}
  3393. */
  3394. JitsiConference.prototype.isE2EESupported = function() {
  3395. return E2EEncryption.isSupported(this.options.config);
  3396. };
  3397. /**
  3398. * Enables / disables End-to-End encryption.
  3399. *
  3400. * @param {boolean} enabled whether to enable E2EE or not.
  3401. * @returns {void}
  3402. */
  3403. JitsiConference.prototype.toggleE2EE = function(enabled) {
  3404. if (!this.isE2EESupported()) {
  3405. logger.warn('Cannot enable / disable E2EE: platform is not supported.');
  3406. return;
  3407. }
  3408. this._e2eEncryption.setEnabled(enabled);
  3409. };
  3410. /**
  3411. * Sets the key and index for End-to-End encryption.
  3412. *
  3413. * @param {CryptoKey} [keyInfo.encryptionKey] - encryption key.
  3414. * @param {Number} [keyInfo.index] - the index of the encryption key.
  3415. * @returns {void}
  3416. */
  3417. JitsiConference.prototype.setMediaEncryptionKey = function(keyInfo) {
  3418. this._e2eEncryption.setEncryptionKey(keyInfo);
  3419. };
  3420. /**
  3421. * Returns <tt>true</tt> if lobby support is enabled in the backend.
  3422. *
  3423. * @returns {boolean} whether lobby is supported in the backend.
  3424. */
  3425. JitsiConference.prototype.isLobbySupported = function() {
  3426. return Boolean(this.room && this.room.getLobby().isSupported());
  3427. };
  3428. /**
  3429. * Returns <tt>true</tt> if the room has members only enabled.
  3430. *
  3431. * @returns {boolean} whether conference room is members only.
  3432. */
  3433. JitsiConference.prototype.isMembersOnly = function() {
  3434. return Boolean(this.room && this.room.membersOnlyEnabled);
  3435. };
  3436. /**
  3437. * Enables lobby by moderators
  3438. *
  3439. * @returns {Promise} resolves when lobby room is joined or rejects with the error.
  3440. */
  3441. JitsiConference.prototype.enableLobby = function() {
  3442. if (this.room && this.isModerator()) {
  3443. return this.room.getLobby().enable();
  3444. }
  3445. return Promise.reject(
  3446. new Error('The conference not started or user is not moderator'));
  3447. };
  3448. /**
  3449. * Disabled lobby by moderators
  3450. *
  3451. * @returns {void}
  3452. */
  3453. JitsiConference.prototype.disableLobby = function() {
  3454. if (this.room && this.isModerator()) {
  3455. this.room.getLobby().disable();
  3456. } else {
  3457. logger.warn(`Failed to disable lobby, ${this.room ? '' : 'not in a room, '}${
  3458. this.isModerator() ? '' : 'participant is not a moderator'}`);
  3459. }
  3460. };
  3461. /**
  3462. * Joins the lobby room with display name and optional email or with a shared password to skip waiting.
  3463. *
  3464. * @param {string} displayName Display name should be set to show it to moderators.
  3465. * @param {string} email Optional email is used to present avatar to the moderator.
  3466. * @returns {Promise<never>}
  3467. */
  3468. JitsiConference.prototype.joinLobby = function(displayName, email) {
  3469. if (this.room) {
  3470. return this.room.getLobby().join(displayName, email);
  3471. }
  3472. return Promise.reject(new Error('The conference not started'));
  3473. };
  3474. /**
  3475. * Gets the local id for a participant in a lobby room.
  3476. * Returns undefined when current participant is not in the lobby room.
  3477. * This is used for lobby room private chat messages.
  3478. *
  3479. * @returns {string}
  3480. */
  3481. JitsiConference.prototype.myLobbyUserId = function() {
  3482. if (this.room) {
  3483. return this.room.getLobby().getLocalId();
  3484. }
  3485. };
  3486. /**
  3487. * Sends a message to a lobby room.
  3488. * When id is specified it sends a private message.
  3489. * Otherwise it sends the message to all moderators.
  3490. * @param {message} Object The message to send
  3491. * @param {string} id The participant id.
  3492. *
  3493. * @returns {void}
  3494. */
  3495. JitsiConference.prototype.sendLobbyMessage = function(message, id) {
  3496. if (this.room) {
  3497. if (id) {
  3498. return this.room.getLobby().sendPrivateMessage(id, message);
  3499. }
  3500. return this.room.getLobby().sendMessage(message);
  3501. }
  3502. };
  3503. /**
  3504. * Adds a message listener to the lobby room
  3505. * @param {Function} listener The listener function,
  3506. * called when a new message is received in the lobby room.
  3507. *
  3508. * @returns {Function} Handler returned to be able to remove it later.
  3509. */
  3510. JitsiConference.prototype.addLobbyMessageListener = function(listener) {
  3511. if (this.room) {
  3512. return this.room.getLobby().addMessageListener(listener);
  3513. }
  3514. };
  3515. /**
  3516. * Removes a message handler from the lobby room
  3517. * @param {Function} handler The handler function to remove.
  3518. *
  3519. * @returns {void}
  3520. */
  3521. JitsiConference.prototype.removeLobbyMessageHandler = function(handler) {
  3522. if (this.room) {
  3523. return this.room.getLobby().removeMessageHandler(handler);
  3524. }
  3525. };
  3526. /**
  3527. * Denies an occupant in the lobby room access to the conference.
  3528. * @param {string} id The participant id.
  3529. */
  3530. JitsiConference.prototype.lobbyDenyAccess = function(id) {
  3531. if (this.room) {
  3532. this.room.getLobby().denyAccess(id);
  3533. }
  3534. };
  3535. /**
  3536. * Approves the request to join the conference to a participant waiting in the lobby.
  3537. *
  3538. * @param {string} id The participant id.
  3539. */
  3540. JitsiConference.prototype.lobbyApproveAccess = function(id) {
  3541. if (this.room) {
  3542. this.room.getLobby().approveAccess(id);
  3543. }
  3544. };
  3545. /**
  3546. * Returns <tt>true</tt> if AV Moderation support is enabled in the backend.
  3547. *
  3548. * @returns {boolean} whether AV Moderation is supported in the backend.
  3549. */
  3550. JitsiConference.prototype.isAVModerationSupported = function() {
  3551. return Boolean(this.room && this.room.getAVModeration().isSupported());
  3552. };
  3553. /**
  3554. * Enables AV Moderation.
  3555. * @param {MediaType} mediaType "audio" or "video"
  3556. */
  3557. JitsiConference.prototype.enableAVModeration = function(mediaType) {
  3558. if (this.room && this.isModerator()
  3559. && (mediaType === MediaType.AUDIO || mediaType === MediaType.VIDEO)) {
  3560. this.room.getAVModeration().enable(true, mediaType);
  3561. } else {
  3562. logger.warn(`Failed to enable AV moderation, ${this.room ? '' : 'not in a room, '}${
  3563. this.isModerator() ? '' : 'participant is not a moderator, '}${
  3564. this.room && this.isModerator() ? 'wrong media type passed' : ''}`);
  3565. }
  3566. };
  3567. /**
  3568. * Disables AV Moderation.
  3569. * @param {MediaType} mediaType "audio" or "video"
  3570. */
  3571. JitsiConference.prototype.disableAVModeration = function(mediaType) {
  3572. if (this.room && this.isModerator()
  3573. && (mediaType === MediaType.AUDIO || mediaType === MediaType.VIDEO)) {
  3574. this.room.getAVModeration().enable(false, mediaType);
  3575. } else {
  3576. logger.warn(`Failed to disable AV moderation, ${this.room ? '' : 'not in a room, '}${
  3577. this.isModerator() ? '' : 'participant is not a moderator, '}${
  3578. this.room && this.isModerator() ? 'wrong media type passed' : ''}`);
  3579. }
  3580. };
  3581. /**
  3582. * Approve participant access to certain media, allows unmuting audio or video.
  3583. *
  3584. * @param {MediaType} mediaType "audio" or "video"
  3585. * @param id the id of the participant.
  3586. */
  3587. JitsiConference.prototype.avModerationApprove = function(mediaType, id) {
  3588. if (this.room && this.isModerator()
  3589. && (mediaType === MediaType.AUDIO || mediaType === MediaType.VIDEO)) {
  3590. const participant = this.getParticipantById(id);
  3591. if (!participant) {
  3592. return;
  3593. }
  3594. this.room.getAVModeration().approve(mediaType, participant.getJid());
  3595. } else {
  3596. logger.warn(`AV moderation approve skipped , ${this.room ? '' : 'not in a room, '}${
  3597. this.isModerator() ? '' : 'participant is not a moderator, '}${
  3598. this.room && this.isModerator() ? 'wrong media type passed' : ''}`);
  3599. }
  3600. };
  3601. /**
  3602. * Reject participant access to certain media, blocks unmuting audio or video.
  3603. *
  3604. * @param {MediaType} mediaType "audio" or "video"
  3605. * @param id the id of the participant.
  3606. */
  3607. JitsiConference.prototype.avModerationReject = function(mediaType, id) {
  3608. if (this.room && this.isModerator()
  3609. && (mediaType === MediaType.AUDIO || mediaType === MediaType.VIDEO)) {
  3610. const participant = this.getParticipantById(id);
  3611. if (!participant) {
  3612. return;
  3613. }
  3614. this.room.getAVModeration().reject(mediaType, participant.getJid());
  3615. } else {
  3616. logger.warn(`AV moderation reject skipped , ${this.room ? '' : 'not in a room, '}${
  3617. this.isModerator() ? '' : 'participant is not a moderator, '}${
  3618. this.room && this.isModerator() ? 'wrong media type passed' : ''}`);
  3619. }
  3620. };
  3621. /**
  3622. * Returns the breakout rooms manager object.
  3623. *
  3624. * @returns {Object} the breakout rooms manager.
  3625. */
  3626. JitsiConference.prototype.getBreakoutRooms = function() {
  3627. return this.room?.getBreakoutRooms();
  3628. };