From f0358d0680ee0c83882d19cda715ea0e9335b28e Mon Sep 17 00:00:00 2001 From: pabloFuente Date: Thu, 26 Jun 2025 17:37:42 +0200 Subject: [PATCH] openvidu-live-captions tutorial --- ai-services/openvidu-live-captions/README.md | 5 + ai-services/openvidu-live-captions/src/app.js | 231 ++++++++++++++ .../openvidu-live-captions/src/index.html | 94 ++++++ .../src/resources/images/favicon.ico | Bin 0 -> 5430 bytes .../src/resources/images/openvidu_logo.png | Bin 0 -> 11746 bytes .../openvidu-live-captions/src/styles.css | 283 ++++++++++++++++++ 6 files changed, 613 insertions(+) create mode 100644 ai-services/openvidu-live-captions/README.md create mode 100644 ai-services/openvidu-live-captions/src/app.js create mode 100644 ai-services/openvidu-live-captions/src/index.html create mode 100644 ai-services/openvidu-live-captions/src/resources/images/favicon.ico create mode 100644 ai-services/openvidu-live-captions/src/resources/images/openvidu_logo.png create mode 100644 ai-services/openvidu-live-captions/src/styles.css diff --git a/ai-services/openvidu-live-captions/README.md b/ai-services/openvidu-live-captions/README.md new file mode 100644 index 00000000..2e65535f --- /dev/null +++ b/ai-services/openvidu-live-captions/README.md @@ -0,0 +1,5 @@ +# OpenVidu Captions + +This is the basic JavaScript tutorial extended to show live captions. It uses OpenVidu AI Services to generate captions from the audio Tracks of Participants in the Rooms. + +Visit [Live Captions tutorial](https://openvidu.io/latest/docs/tutorials/ai-services/openvidu-live-captions/) diff --git a/ai-services/openvidu-live-captions/src/app.js b/ai-services/openvidu-live-captions/src/app.js new file mode 100644 index 00000000..1f5f66e6 --- /dev/null +++ b/ai-services/openvidu-live-captions/src/app.js @@ -0,0 +1,231 @@ +// When running OpenVidu locally, leave these variables empty +// For other deployment type, configure them with correct URLs depending on your deployment +var APPLICATION_SERVER_URL = ""; +var LIVEKIT_URL = ""; +configureUrls(); + +const LivekitClient = window.LivekitClient; +var room; + +function configureUrls() { + // If APPLICATION_SERVER_URL is not configured, use default value from OpenVidu Local deployment + if (!APPLICATION_SERVER_URL) { + if (window.location.hostname === "localhost") { + APPLICATION_SERVER_URL = "http://localhost:6080/"; + } else { + APPLICATION_SERVER_URL = "https://" + window.location.hostname + ":6443/"; + } + } + + // If LIVEKIT_URL is not configured, use default value from OpenVidu Local deployment + if (!LIVEKIT_URL) { + if (window.location.hostname === "localhost") { + LIVEKIT_URL = "ws://localhost:7880/"; + } else { + LIVEKIT_URL = "wss://" + window.location.hostname + ":7443/"; + } + } +} + +async function joinRoom() { + // Disable 'Join' button + document.getElementById("join-button").disabled = true; + document.getElementById("join-button").innerText = "Joining..."; + + // Initialize a new Room object + room = new LivekitClient.Room(); + + // Specify the actions when events take place in the room + // On every new Track received... + room.on( + LivekitClient.RoomEvent.TrackSubscribed, + (track, _publication, participant) => { + addTrack(track, participant.identity); + } + ); + + // On every new Track destroyed... + room.on( + LivekitClient.RoomEvent.TrackUnsubscribed, + (track, _publication, participant) => { + track.detach(); + document.getElementById(track.sid)?.remove(); + + if (track.kind === "video") { + removeVideoContainer(participant.identity); + } + } + ); + + room.registerTextStreamHandler( + "lk.transcription", + async (reader, participantInfo) => { + const message = await reader.readAll(); + const isFinal = + reader.info.attributes["lk.transcription_final"] === "true"; + + if (isFinal) { + const audioTrackId = reader.info.attributes["lk.transcribed_track_id"]; + + // Due to a bug in LiveKit Server the participantInfo object may be empty. + // You can still get the participant owning the audio track like below: + const participant = [room.localParticipant] + .concat(Array.from(room.remoteParticipants.values())) + .find((p) => p.audioTrackPublications.has(audioTrackId)); + + const captionsTextarea = document.getElementById("captions"); + const timestamp = new Date().toLocaleTimeString(); + const participantIdentity = + participant == room.localParticipant ? "You" : participant.identity; + captionsTextarea.value += `[${timestamp}] ${participantIdentity}: ${message}\n`; + captionsTextarea.scrollTop = captionsTextarea.scrollHeight; + } + } + ); + + try { + // Get the room name and participant name from the form + const roomName = document.getElementById("room-name").value; + const userName = document.getElementById("participant-name").value; + + // Get a token from your application server with the room name and participant name + const token = await getToken(roomName, userName); + + // Connect to the room with the LiveKit URL and the token + await room.connect(LIVEKIT_URL, token); + + // Hide the 'Join room' page and show the 'Room' page + document.getElementById("room-title").innerText = roomName; + document.getElementById("join").hidden = true; + document.getElementById("room").hidden = false; + + // Publish your camera and microphone + await room.localParticipant.enableCameraAndMicrophone(); + const localVideoTrack = this.room.localParticipant.videoTrackPublications + .values() + .next().value.track; + addTrack(localVideoTrack, userName, true); + } catch (error) { + console.log("There was an error connecting to the room:", error.message); + await leaveRoom(); + } +} + +function addTrack(track, participantIdentity, local = false) { + const element = track.attach(); + element.id = track.sid; + + /* If the track is a video track, we create a container and append the video element to it + with the participant's identity */ + if (track.kind === "video") { + const videoContainer = createVideoContainer(participantIdentity, local); + videoContainer.append(element); + appendParticipantData( + videoContainer, + participantIdentity + (local ? " (You)" : "") + ); + } else { + document.getElementById("layout-container").append(element); + } +} + +async function leaveRoom() { + // Leave the room by calling 'disconnect' method over the Room object + await room.disconnect(); + + // Remove all HTML elements inside the layout container + removeAllLayoutElements(); + + // Clear the captions textarea + document.getElementById("captions").value = ""; + + // Back to 'Join room' page + document.getElementById("join").hidden = false; + document.getElementById("room").hidden = true; + + // Enable 'Join' button + document.getElementById("join-button").disabled = false; + document.getElementById("join-button").innerText = "Join!"; +} + +window.onbeforeunload = () => { + room?.disconnect(); +}; + +window.onload = generateFormValues; + +function generateFormValues() { + document.getElementById("room-name").value = "Test Room"; + document.getElementById("participant-name").value = + "Participant" + Math.floor(Math.random() * 100); +} + +function createVideoContainer(participantIdentity, local = false) { + const videoContainer = document.createElement("div"); + videoContainer.id = `camera-${participantIdentity}`; + videoContainer.className = "video-container"; + const layoutContainer = document.getElementById("layout-container"); + + if (local) { + layoutContainer.prepend(videoContainer); + } else { + layoutContainer.append(videoContainer); + } + + return videoContainer; +} + +function appendParticipantData(videoContainer, participantIdentity) { + const dataElement = document.createElement("div"); + dataElement.className = "participant-data"; + dataElement.innerHTML = `

${participantIdentity}

`; + videoContainer.prepend(dataElement); +} + +function removeVideoContainer(participantIdentity) { + const videoContainer = document.getElementById( + `camera-${participantIdentity}` + ); + videoContainer?.remove(); +} + +function removeAllLayoutElements() { + const layoutElements = document.getElementById("layout-container").children; + Array.from(layoutElements).forEach((element) => { + element.remove(); + }); +} + +/** + * -------------------------------------------- + * GETTING A TOKEN FROM YOUR APPLICATION SERVER + * -------------------------------------------- + * The method below request the creation of a token to + * your application server. This prevents the need to expose + * your LiveKit API key and secret to the client side. + * + * In this sample code, there is no user control at all. Anybody could + * access your application server endpoints. In a real production + * environment, your application server must identify the user to allow + * access to the endpoints. + */ +async function getToken(roomName, participantName) { + const response = await fetch(APPLICATION_SERVER_URL + "token", { + method: "POST", + headers: { + "Content-Type": "application/json", + }, + body: JSON.stringify({ + roomName, + participantName, + }), + }); + + if (!response.ok) { + const error = await response.json(); + throw new Error(`Failed to get token: ${error.errorMessage}`); + } + + const token = await response.json(); + return token.token; +} diff --git a/ai-services/openvidu-live-captions/src/index.html b/ai-services/openvidu-live-captions/src/index.html new file mode 100644 index 00000000..916a6df8 --- /dev/null +++ b/ai-services/openvidu-live-captions/src/index.html @@ -0,0 +1,94 @@ + + + + OpenVidu Live Captions + + + + + + + + + + + + + + + + + +
+

Basic JavaScript

 + +
+ +
+
+
+

Join a Video Room

+
+
+ + +
+
+ + +
+ +
+
+
+ + +
+ + + + diff --git a/ai-services/openvidu-live-captions/src/resources/images/favicon.ico b/ai-services/openvidu-live-captions/src/resources/images/favicon.ico new file mode 100644 index 0000000000000000000000000000000000000000..0e2249ada68ec5cab2034721dc193285c27175b5 GIT binary patch literal 5430 zcmc&&eN2^Q6o2ox;0z74F{f9TU#+!9X2#sY&6#cG+%jk7$GvdHRGeG+hii#qr9`BK zC}qeHvGgi7)2x{@AZJeQ2i$vM6vot;IU_|SM7+HB^gGY{zHsji5d!CRKhN_%yyy9y z=RD^*=iDnvI!P}LA1>iDPFi7n3LB+bNp^oNLalA8=H z`-6iYNhVd-0{wN8JM*q}0bsYHpWyM3&HpH+LU-f&>6Fv>650J0N)zjuDZSc6C3#&o z_*8vxN9x<4|6}uZ>X2_!&8_cgL&Ni8P1fJjXZ?H%g+e5UI_YNcD%N;b@b^{!L~|as zb>5(}El$d8mIy_@DizA(Ef{Umop0o%=3L z^zNk@HLHP)NK~()6z}r(9R;IG5d)tho~Gi=Phk!9{FF1`IJgHmKAUu|POBE<&`n0{ z`~Z38{s^(X>5?n*o?(vf0mpJ*5OLQf2{sP^oM*-XGXX8nWQp8_iLj5h--j)QuU!4l zcm1^+@nJ!H#Q|OZ7U$!lB*+;+9Dv+6c(yQ?ig?KRuwfJA2(}$O93#xR6=(vGv*`&y z~xQi3P znSt>+$PP%p-|K*(fL5#6->6em58#f9dwT`8?80~sWW3~-#d&2N8zSU^9Ld0NMuE9` zU0^h@05}9(1DKb=<5>W|Bh~^3^C#l|mcS33GlBq1_=8XjLYX?ZoD}Q18pHgh+Z66- ze$}R7*k=mX&IQf`8gEb?pMo3@gvTHA^LejSIn_MHHi(?nVsPI+KE`|0k$G@(@{ufk za@hw`GHPh@;V|Gi<mXv<+e z?JUxZx*lZ%pG7N>0j{Tk)4)w2h#25=kKmu+-A8Zu9~bq?9x%)HTCzBv z<}(v)1WdH7#zYzCO!UcqJ;5j8e$dXO7+miGTFj}u8oyGnCVO|&BL7&yuk%i zsKG{Z1cr3|jsG4FTb-HKRv4)`Ul+lTz4KX=g1b=NZ`i&g`KPG-4s~s=+cv*}R@5fY z^4bx!s75b1H9NxVI(!8m80m{I2Zui`V8NdClu`E>xo&(z{#z#~@8WCVA4-dTdicT8 z z^&i{7;OFL!i&WH<-o?MF$|U?hxcu7wWwjTU;e#OEk^iAfw|%th58DIf&uq~6m3`ll z+vv~sU(ws|L~J~V80GI655oUS{H_4L!-1#x4w~zmNelgx=yl(OK4W2E0;N`2gZaB-FQW#Z2Y(}YtARXVOz-?$ zhq`ST!m( zi)i-rQ~rkcXLa|*I`Mr#?Y$f-H}m%b?o0kRPC_@yT2a&0b85DL6Me7fyL#Eb=7)Yt z<+qnctna`%57RiqCFc1ItiTf3xEV5c5b-Y7nuT@a!Z~{y<30WkGz^lziwzJVMc>6e TedKQfJ#jzGxv-xC9?I}vocwV} literal 0 HcmV?d00001 diff --git a/ai-services/openvidu-live-captions/src/resources/images/openvidu_logo.png b/ai-services/openvidu-live-captions/src/resources/images/openvidu_logo.png new file mode 100644 index 0000000000000000000000000000000000000000..e0309e62181608cf3543664ced79b6355779533b GIT binary patch literal 11746 zcma)ibyOTr@aN+0wh&yGKyVB0?he5v!C45hxclM+cL){&!NOue7Iz2|0wKTx!Gb#k zZoj|#>+ZdK@7~Px%yd_ENq@F#Uri_IYO4_7(%=FB00K2tMSTDOg#h{d7aJ4Veq>^l zM&8ih$!W;}08OcQkG2@dcSd_veJubWkR1RBj|KqlkzL_?0Dvza0B~Rf0Ep)T094?@ zPCZHF0H&RWiX!0ozoWFLIuqH016DPA4*+lx|97F7e;>d>c4GOcX(?fCVgYf1f|ztY zp#T7Py_%w&A>`-ZqJY9mBj20eKhj2vt4A;30(^XEiQ#VWts2llsoFxcBj)y^Vy4rA zV#R4hUWAFFq6kH@1~UzGmq3nE3-uU#oK!a#1qB65j*>2GrM=kdAmBLQ8Fo`!cT8rTxekMFo?=SC=Sk08;clj*4U($5u3Id7`2|X;2We zCR!Dmr7VgQOR%PSDnbC7!}x<_)0JTs?UJz`B{cP1;@(svu^LS^+{T|(HdbYyW9?!j zy!FQ~@yhRu6w!EQfO`^hEQq>Z>IY`(IMfkRXqO293-BF#%La&`AacW^$D&ufeGSG_ zDlUJKi|UhE3gR(mpx@4Il0KTVZ%1mj{o8Oo4^T{)MXr)(f)a-Ehy&*9U;43M#W+6E zw~TM!nx5a7Qk0rtwPCeE6Ya@TA9wp@k|A@>BOSv&M7+Yk--`4fh7p#01&|d|S_Cx+ zCjvCmw@z_?vp=U_L6r+AszJ5M) zGOQ0+&Jw2t8>Hh75LO-AdQEyE5(&D~4`d-y{R6}T8$Er?wJ&Qsm}BKM0eD+Yh0HmK z(+^{jVeZnKKWc-@xyBH~9T~;=!38c~zSrZyf$^ln>L@V4PNwQk#H!)4)y;Bd+|87iR|#g0VVz#Mn&9|>Gp->rof0P#0PVkkZtJ{-dD!Z7d* z1vA>xEa^3vjjn9q6Qfwl@iho(H#BT3M2{-dUkc$PhP-5Pk5DX9uq4&fs{*zOB?&O* z)pg&AeDSFcdj}j&(qn|3b0Ea1zFvPbv zG*w6GPuG(LL9aIPOX@J1(!U%jkDY2_u9Jn?dnDK%N#7|BcvTkCwA9hHKx&Z@nLZF<-y+F91yrMN_i zbiE8t2I~h*X~!`iDdqClN;$*%{1})9(KVvc)d0)n*~*&YV;Ea)eXNth{LsL()G{)) z@RZ?H7xWv4o$yQvp3p0WAH}vnv@wQZm9oiFDq_VGnnO6vF-|~qh1xz~u ztnET-Fr~K)pt4C&;k~Q;R_$MfJvlp|^1o5bEJhmjrBT1`B#!jw0ut*+5l%k*3M_${3!~8EA+)i;2|2_5wp@nt2|sXY&4_J) zn*a`conabSUgpJn)?y31s^Fv_W+#ocJ)&f%`M+B&-KJSSnm8?IDuXKj_Y$tvuF{)DuIa0AJ4M^O+&30nl@;7g7rQF*}0J!(AjfgX7R9c5ssFe?iG z91uw+!kX*Tn5+&i4RuQy_E;{-O^GDq#xvu?@@vN^DYf-OyD`Rx2j;cIx919?aU~s60ftr038b7c8`Zm>E-8hjOY)`WkJ^l5 zHV6mU#gEfyV1R&);3@Gb-UcP@vqtaryk(@CBh|~?s^V6LpItU9Tb44yWXb6xCgOUW zZ$RGe0wvGji;j^g=1fv2%7=Xr&(kNnP<0mlJ9Odr*xy2C566MNB9Z0kq9uMuk5vIQ zFp|Z_C`semaBn$O;_L7-+Ba&IJbMhSKr`Slv&kr#ln-Y}i&V=P=Zm6s^NZ|$SKxMQv zypgjsOPV)r*wO?zABA(B7Se+kM>}E=rV3QSVO7LGV{?DX&-cQ@NU`q7atBgy%_q9qA7GB z|4n;aCiBid1Qe@BN&W1@yntYR@^E4j!vJ2pZAq*^1F zUFHChG!OWdy+z%Y`*ChS^|5j0raWI?ReUea4x(ic7{com``*2^gSpOyLYIIn*;t8K zvbg!gUha=vA^(nP%Dz~5Poe?mhG~hrz0q$5Sj&UgxArT!(B&HyQj^MUb%>EG*5W{} zQ!683Sv_Y_!ywgl0M$v+wK%4UTJ8jX%0cc#o`KcSaD9QR$S?T2rKj+B_r?Zbx-5%` z$-xS?rd;JDCT!|rKa=g@f6|i=)kX1u+Iw|wmgk(I) z5{(oYF8wPV6o6ClBUGydS`$E4eh zNtrUsL^shhr$9|1^LRt41lK>e)3Y_^4o>jEaL7j9oBXkyn|lr8$!GL1QN&aht8Gvx z0S0N)oBEY6I;~2?eHA{PBGr(%c#Y#E; zVroj}<2U)5B=4=58IUcISc&E<&8`@ffW z(uKJYsEVc#l)u7QvJksk+p5nJt8k?4Av6~*aZ@dNSY`d7B{@vZPBWaF*_bu8V2~Cq zSVcP`bs;@0x*MDpwfe_!kcIyYNR{gZM4&S1JmPN6v12^B9JsXlpwdWbuu73LE(4uv zuCucJB-4NmrC`64UOR1POeFmDwX`IasmTcJEd)&^**pBE^Uo;%0|V7b0DDW4K{>?1 z_;pAY-y9!JWd9cbtNpD^9pIxb$j_PO##-=rhc{ZQWc(*EA*0po8kQy@C2)^KR9aUs)hJp&=DEB=;?uwB6F%1}1ogQ0JBe>Jn{x%myAK$#G$bY}=`_8?0Uw>6n_ zdRfPY9kt^nzdQkRT^|v1AD921fmtVY?+F%zneED`!|Q)R(}jVkQnffE;HFRSgoG2s zBoh^Gf3BZw{%FXV%Z%B%8J_*Z^-f5NkjY4=+7*$plH`@Kab_Q4N|1y!j+DGy<2)7z z>*AmxYVYQs2!(_qa+$N4j8Yl7j|z#JwBwo{ei#XwV5BYz3KfPG7|NkZBbEBb~W!{P-*H13xXUeFz{{&y)Q0 zfP@4$18hBG(0%A{ZEJMmBA$_=-b-Qcgp{PEL^;GvqSAhXcz+l=_|es)T;)NF?;skf zDEUI7l9^z`%Hw&ed8!HUIbMti!E31#hbNMK%@;GBvf<6+)p+DvoOj zF?!>w{~z9CS&1BWEq6Uno`g#*-jlVvhXBK`E6EI}I)TW13XNsHELc{zzQYPE-rQ;v z_4>X`QJFu#D~>6YBXW?66i*CFG#N_R086glsPMdbkZSnlBii#VPGnha?!)Lp=8Dfj zyj{61)YS#4|H#3)vUJxmmPOB|-`C1FAhseOR!ceVg+V(Zq>G2yqK523z9#cFKI2$h zJ(De6Hdg2Q%F4viO>`nH6Kh$}0QBeFl9cI_corRR4iCmfC!k-pNno^=}X8mlgp1V1#C4FiU zDe_b<*+Z~?ML4pU^2dCw`L9W^_mtLJ$6r14GO7J$izKi3gjoIq^d?=_UGqn~hs^(m zAHj!c4hPQubm8XdgVkRyO1;&ZX<==c@_v;MK&CD^oDiA7*2$Kg zt4Xe@#HpwQmKSXul#Wv{kBbnCZ`Ti!uz#Yg4TdCmE!;E=NcwWdl)w8Tp(_{M9Da1r zI>I-C@?I}$x6L0Rt8k0fUG^vc)e13Mx)_}7+(iduA}6j37yH(GB_}P8m|}(RIp%Y` z?Eq2w`!sHC35$9iF2$WexFWv~{zpk&oZP!tc5KhT{mo!*1$9?gi#;`D9yprzt6SvL+MO+`& zB9P0NnN~`Ia#H%{zN$FPew8Kow8OL9$rKdJVU()E^*rE8ooF0cIP*c&Yl-106GO+M zulI8=1=0TibF$M3XHv>pZs0yeyTK~##Y~RqMMuy2*yB96VWgNLiJ^S`rT-4We{gc>Z+g_#_@HgnMmVm0m}nU)+O=DS4u?DYGVQ-6Pb zx;4A8cYEpib>F}qYYtfSXlHM+apnWl?rbaZtndBc>2^!)-cVG|3dypv9)7SQPDn7b zWT(W$FtTyndFNXF%gzBpO8apwu9Vds>`3uw)+aPo`$_qNy($L5*4Ov}qBRFW#|=N|=F6R?WGbd1%j5%_R$K4jdEe)gRE>811K`QPFRi)n9&w|HZeSXq+z}^8+JI0Y}_QCMHqj zfQ_i)4}fHG$+0Ozp{)=GYNzc>2Q{*U*yv{5rVRuy;)Le+odC2+nfyNK)>p7kcq9$C z+>4y?gFf!fZneY`);l0UGA=81X83GjQ8mI%RL>gBUX+n%s&ZLsL zO2Ly7?usZ8IWKav(N~JGppC={>HP&vyN<%-a6BkFoPA_ zhcFJ`_6I!HMcK)lz-9dLATbLjzsLXqY_nM59B6^J;$W(NA?g(o1cCa~(HCoess=_J=usBY%XiENv#06x2{C)4mE1Z zu4D*cr?bF{LR{=h#%?bE7#LMs7RxbuTo1j#4yBlp{04<#j2CCO4qtX_C-yT#T7il_K!jXIP4kz zri6@Yn!F*T0A59yTBCT#jG@;&LR9(K+bG|z?N;3Pj!`Ck@q-DE`T3SM ztO0oXR)siGA-oZ#kr_&2eesYDXA#Q^TI1FRefylT=O{$oK^#BajW^pSsA@tN-;hVK z^g$>T-@cF9;Pa;omks(pz3d#GWD6Er01h=Zj?#u_cq&Se9zn*gF;45~k$tFRkeXPx z4{quN`A;=2%J{j`1;WrdMr<`qXB11BqNCb>r(wASd9EUd<=z0$20~u+laR`~vzD1tD+GvcpLBkp@+BV^BbUSvja_!{el8v3!9xl22eFhPrQweyC zSHAc)$r3*-Ax4G65UXu2+pay>n3oXdq2q&CV5E#`HN!xw!|aoC@L*ZT`Pe+bWSb70l`lVkzPm2hw589Z|r@@>B9Mo z*JJr?CZ*rDmsw{%>Y|jO^Q+?RU2FRsqWgR&f4r~VTf))hiRsl60KHxOq5MAMw@`Zq zL^T-oFDL%ySR+@&)2#ykuz)1B()oTgk7OKLBU%dUpzJQ7NT>#MH1C^G{aiiNeu~!4 zKzEsHxvp&S5bjii&^62c)hc@1uxS~ubPFPOX2Mo94__B)ZG5$D;^QAn&*se3JrV#m zYs-LK;3{b^9#X!hh0qQ)xi!Vvt|@g!ZiJJMQ7uZKE7|>P^s^EFl8-u09vz~0-N#Sh zD4>h_6I*_sfEKH}VmJInBDZ$W`quSsu)1Ws|P(B_{#ea5vObIIJ*~KD{UFKohz*g?G6(z3b-TuBT9cDGHjFab0xl^l{e55Ie#Z=ixiTffm zOq)q$3!$F#9q|dl$jCS7O44hUzdm6(v?9quw#P_kCd%foRH(8%$@=eV0txH^*N>qu z0KCdPUzK0oDLfR!chU8yR~6g&nlAlI;2AkS%^^TsIHK1(3nzb;NV{9 zhAQQHI*;aMQZbk4-Nj69g$ym9rX9(phvLpzt~j366jAISE(QOpb0SPldmPkAGh?o5Zgl zHNSoD-=F^+#+^i`XQ_-3{@~gS4={1T2Z1CxEFW_UCWtaaZaWHwFn^wsqX>*z$mypa zYd3Qc_Q^<8FHzKL!99N-DqS(nPyP|Ja5+KyHFijhAJxBns<-h8a)V=#GinKzlEBXdaSiEy#~;j|P(&?D-rAj;3arSi zw2ZjB9*6!C`Km3JWfve){K)i z7Ncjq&|#_NaE>aL27Sm#Gc}u^mHNyuEfJFAC)ru<#T$^{fl7y+3V8S~pFPYd@Di_S z=T15U?_0t2-F=w$PnKU_RC>D_-OH~ve=7;4*3DHBCKf`@u9whmS z+S0N3D@B75_F9Ytf;XHCTlkGjqvfZJH@nstPlV~{CxV?1j0U;VW~vYGy$F(o4HXLE zLuFqrHwM@ge%|dR4)Olrnp9-FAG?SM%Gp+lxdXd71n@5?4UoVh# zP}6@JTWPAQFeT@fE5C~dQ*7@wNpE|N?=1HVX4)7NwdT;N zf~IiEB8+{Jb|0c_g6xx#seYAh^zWQy$)gkl@>T_S#Jk4nt3^#yLg$sxii z5?pzRVtfV%!xX`Oh+cLv;e$H?+smGtnqhXUh5}6KC5G zgC`B+h8cl8W3s)?>@Jf~%W6c!?Oku;Par;+?)n#Dn_7M7bz0f^5kI@1&`l%G0|nNj z&Mhp=NzXenPN}>nQ+9}wEp1jLCUYNqjs>D&m?w@Uit z$ZAMU%aISLKBkgrFd&0ffvtanQoxdO!b-FNY2KzN;}|(B4jr*Q$$I+QW<2qGLDuWg zS0v^lDYv02;Yb6Wrt0I<%DjvnZ!* zbhXRH+t;wm^$ru=0MeS{@&d4Oy2X05!F6x6Bledlan{AdbcROEQYgN_ij(I4{4 z$IXwq!^kk;)s5XsAf!OT)8nP+Z|r}WL%jTx02#Ya8pdo)whKUU6~XDKoNAi0FE_ko zd)b_lgR+ZI{uJUmV>-(?WpARBYW-+^vPCZI`=~DNJB8a)u&6p@>W0WZlXr5IU}I63 zBh!mGjp*~4i{sH61<87HQnG#P?%S6msegp+Lw*eNv|P5P(JG_9|H}3JPjNVFf6j64 z5KOC9vpVO*qv6r7@E5+4tZ89ChzYj9E#cLDz}iSMtd1Lg(KfNPj7F7yMiCuq5q!Qq zhAaV5YV}hr$EBR{@bu3F>(@GFjM|o#FyZ$pn}wDzAfz<+0)<0D)bnwj%L~I?Ed7O; zvz5v5Yw{sUv0p!u{E4wh=S>^*NHh!nnaeeAQP{<5O24i^`Ob{C-_h)OWUm>Fd5WLB z*}NU;C$!p0R9+Z++80m_{gHBzxUN!zk*|Zn*^61l7n;%OmtE>hnIeJRL20`Zs3kiY zS*QhlY2k;asSi8mx&6Kz`ykJX#$FLfe`-4%W@qX#7M5$XLbbi^U*1%GUisLBLMh=Gv;}_vQ{7)|RXzCK3%wTkCYgxM-Me7#h$`SO69n(;A zC(^8YQ(-8+Bur@Yh9YN&4r-ml#xTPX9UREO{m}YNaMagCt*0co&dAFr{S5Sl*Zxob z(Ox31eUCdTC>jja#^=xlMIxEY29J6MOlk9R@ytRQ_b$q<+=F?%PV=n2KPYrdega^Dd`WMd!^<$$ut;dB$ zQ;D<@gx*T$ZOpl*K;FLd?;C|fy4TSHXUGtn!B+nOhjUv7lOiS@#|&uJ6`9Gv5b!|f zzVE7>Wyw<$r4vYkh5WQ0-D+$PL(bnvDXT@#LuISk7x}-jETfBCiU?k<9j7C;I}oyi z;7*cYxFtr6I0gtVlHVQ0boQO_TuGH#g`27|zc4)Y*S&)M(KQm^c?l&ENyULlvlP*%Zjp1M=5aARMJdcnb|(OaO$BO!jH zq5F?=JiV`)`d=IOU2YJ@7U3su8?NgGUj$s)6OEmO>@E*aQr^i%kksIF8;<#l@TBmt zvir^GAIfVjW|YJ6@At15&0i%{kdnc5NeR(i89lT69q3bYh5ZToEhTfsPV=_?17!62-RcP-IvG9_T9ZUk%EdUX4dQ#n zqg$XBVv%WX;y?z*IaP{YS0`g;DBz%SR~`habeB#rtCv?GLx8K^6XESkU0GJg{nNmn zr4cE;x)%2F!urc^efE3ca#f^dCCVj4opWr@5JQ9v2?BpDolrn*@ena$FY%{gm_J?KXTCy5Jy0qJFd}B^6333k!Wj_3u<%9y`(N? zeMBNFJGnBN_gylRJ1Pz{s@fNTF1S(gvSne}aqQL8_i#@%oQ5>7Phf5ihgvslWuk~=EMvjX$3S_||?tQyQ`jO551LEOkDioR91T@;~JS&^Ha1iSB0O7`|iY z0q1WvBZY7#`1^4PUTJgXf7M09A1X2gka`x z__B6x8Q~GhtmjNm$B`hClC6c1s zn7tl$6M4bk18N=z`DcO(=NTiGHWaS)>)vbykx9-I{CY8N22JU9wOZ^>!;;hmYNkwLQGJA`i zV)*@bto3`%okh!|cDA1u^$A`gb;r*qJnbnNb?P08+no~eLH>hF+Ito-&OlE1`VUDn z`x%^xc0T-YE{_@>u)nI){FcI*zE+CzEw^pq-*IjY>8Sa*Q}wJ7l#ymOg>${wlj2Eq zTu>1W8T}ZMa6V7rPjLGm$DWfJE)hE{mh)Ik~Thb0Jj5JUhmG=nD z&@F^zR9+DD1u^l=Sz8=>(Pu+!3q zV`!OOhz~-MsT?iQCARH)IT2_4)EIgtWUQZTf$qvY({wu5jLkGHAFRMIIxyF>i~QDS z;YW8XmNpo-giF@`E?(@b&m#qx{|nV!-50)>VaccO7<-i#H}z*a-Vr+AT%81+^MQe< z(i=TTPN0AS5`L)d`$eNKp){9}J@p7XQt|!-ESXF`RBN*5d+n@Gx=SOqYhNz?R%VU6 zQmV7Pk(=XqOe}~F>=)$G2O}IlK(St-pD5uB#auw^G&j5X{dDl*Kn0!-!VFk3+eMj& zM{U+7#k_aqZeAs6A``Df$Y__q93S-URx_+hG5)i~n8|lcgnfMfjQNv{!Lr~eZ7F>$ zaw{{NkCLg6gRPIFxV^U{@&*v#;}?C!C;Cc2$dI2;TtG-%nEw@@kT@S7PkZn8|AWEZ z)4};|!2g@U`T)xl$w2*|1Ov~vKK{1ejsSmue;#KK*Z20eU`HNL?{@{qk~BynfSQuF KVuQR*