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 143KB

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