Kif jaħdem MousePlayer
Gwida sempliċi għall-arkitettura tat-traċċar, riżoluzzjonijiet bejn apparati u limiti tas-sistema.
1. Għaliex ma nirreġistrawx video
Spiss jaħsbu li għodod viżivi jirreġistraw video bħal MP4 jew WebM tal-iskrin. Dan juża ħafna bandwidth, inaqqas is-sit ħafna u joħloq test imċajpar li ma jinqarax.
Minflok nużaw teknoloġija ħafifa: Telemetrija tas-snapshot DOM. Dawn il-prinċipji bażiċi:
Stampa tal-istruttura
Meta tinfetaħ paġna, l-iskript jieħu "pjanta" testwali tal-HTML u stili. Jirreġistra fejn huma l-elementi bla kopja tal-immaġnijiet jew videos; il-player jgħabbi immaġnijiet mill-indirizz oriġinali. Canvas eċċezzjoni: il-kontenut jintbagħat bħala immaġni (ara taħt).
Telemetrija tal-koordinati
Nirreġistraw fluss ta’ avvenimenti: maws, fond tal-iskrolljar, miri tal-klikks, daqs tal-browser u bidliet tal-paġna; skont settings ukoll console, talbiet falluti jew bil-mod u Web Vitals. Movimenti żgħar; snapshots u bidliet jistgħu jkunu ferm akbar u jintbagħtu kompressati.
Riproduzzjoni tat-teatru
Fil-player tinbena l-paġna mill-pjanta rreġistrata u kursur virtwali jimxi f’ħin reali, bit-test ċar ħafna.
Mibni biex jibqa’ ħafif: l-iskript jitgħabba asinkronikament u jibgħat punti numeriċi żgħar minflok video. L-effett fuq Core Web Vitals jiddependi fuq paġni, hosting u network; kejlu fis-sit tagħkom minflok taċċettaw ċifra tagħna. Ebda veloċità garantita – ara taqsima 20 tat- Termini tas-Servizz.
2. Riżoluzzjonijiet & apparati mobbli
Minn smartphones żgħar sa monitors 4K ultra-wide, siti jbiddlu u jirranġaw layout għall-wisa’ — Responsive Web Design.
Kif inqabblu ż-żona viżibbli eżatta
Biex ma tidhirx distorta, nirreġistraw id-daqs eżatt (eż., 390x844 għal smartphone jew 1920x1080 għal desktop). Il-player joħloq sandbox skalat bl-istess proporzjon bħall-iskrin oriġinali.
Skrins desktop & laptop
Nirreġistraw maws kontinwu u navigazzjoni bejn tabs fl-istess sessjoni browser. Menus fuq hover jidhru jekk jibdlu d-dokument; hover CSS biss ma jidhirx fid-dokument u ma jiġix riprodott.
Smartphones & tablets
Touchscreens bla kursur hover. MousePlayer jadatta b’mess, swipe u bidliet tal-orjentazzjoni (portrait jew landscape).
Daqs li jinbidel waqt sessjoni
Rotazzjoni tat-tablet jew tibdil tat-tieqa jbiddel il-layout. MousePlayer jaqbad dawn l-avvenimenti u jadatta l-canvas tar-riproduzzjoni immedjatament, iżomm il-kuntest.
3. Limiti tas-sistema & konfini tekniċi
Għall-privatezza, sigurtà tal-browser u pproċessar veloċi, MousePlayer jaħdem f’limiti definiti:
| Konfini tas-sistema | Kif MousePlayer jittrattah |
|---|---|
| iFrames | Iframes tal-istess origin jirreġistraw il-kontenut u l-interazzjoni. Origin ieħor (YouTube, Stripe) ma jistax jinqabad minn ġewwa minħabba Same-Origin Policy; jidher placeholder u ma jitgħabbiex fir-riproduzzjoni. |
| Oqsma sensittivi (PII) | Passwords u ħlasijiet moħbija fuq l-apparat f’kull livell, u ħabi sħiħ l-istandard. Taraw ittajpjar, mhux it-test. Żewġ limiti: livelli aktar dgħajfa biss b’approvazzjoni bil-miktub, u ħabi ma jilħaqx dak stampat fil-paġna – indirizz fuq konferma parti mis-snapshot. It-tnejn fid- DPA. |
| Elementi Canvas & WebGL | Canvas irreġistrat bħala immaġni mas-snapshot u kull bidla, sa madwar darba fis-sekonda u b’limitu tad-daqs. Animazzjoni tidher bħala frames. Ebda immaġni minn żoni moħbija jew canvas b’immaġnijiet ta’ origin ieħor; WebGL jista’ jibqa’ vojt. |
| Web Components (Shadow DOM) | Shadow roots miftuħa jiġu rreġistrati bil-kontenut. Magħluqa inaċċessibbli għall-iskripts; il-kontenut nieqes. |
| Trasport & ħażna tal-browser | Data fuq WebSocket kriptat (HTTPS/WSS). Jekk ma jistax, eż. proxy, tintuża triq HTTP kriptata; snapshots kbar ħafna jittellgħu separatament b’HTTPS. Ebda cookie; local storage u session storage fis-sit tagħkom. |
| Perjodi AFK inattivi | Jekk viżitatur iħalli tab miftuħa u jitlaq 20 minuta, l-inattività tinstab u tiġi kompressata fir-riproduzzjoni biex ma taħlux ħin fuq skrin wieqaf. |