ఒక ఇంటరాక్టివ్ యాప్ గైడ్‌ను రూపొందించడం

సపోర్ట్ టీమ్‌లు తాము ఇన్‌స్టాల్ చేయని యాప్‌లను ఉపయోగించాల్సి వచ్చినప్పుడు తరచుగా ఇబ్బంది పడుతుంటారు. PDF మాన్యువల్ అనేది ఒక చెడ్డ పరిష్కారం, ఎందుకంటే ఎవరూ వాటిని చదవరు.

బ్రౌజర్‌లోనే నిజమైన యాప్ స్క్రీన్‌షాట్‌లతో వినియోగదారులు ఇంటరాక్ట్ అయ్యేలా నేను ఒక టూల్‌ను రూపొందించాను. ఇది నిజమైన ఫోన్‌ను వాడుతున్న అనుభూతిని ఇస్తుంది. మీరు స్క్రీన్‌షాట్‌లోని ఒక బటన్‌ను క్లిక్ చేస్తే, తదుపరి స్క్రీన్ కనిపిస్తుంది.

ఇది ఎలా పనిచేస్తుంది

చిత్రాల కోసం నేను Firebase Storageని మరియు లాజిక్ కోసం vanilla JavaScriptని ఉపయోగించాను. దీనిని తేలికగా ఉంచడానికి నేను ఎక్స్‌టర్నల్ లైబ్రరీలను నివారించాను.

దీని వెనుక ఉన్న రహస్యం పర్సెంటేజ్-ఆధారిత (percentage-based) హాట్‌స్పాట్‌లను ఉపయోగించడం. ఫిక్స్‌డ్ పిక్సెల్‌లకు బదులుగా, నేను 0 నుండి 100 వరకు ఉండే కోఆర్డినేట్‌లను ఉపయోగించి క్లిక్ చేయగల ప్రాంతాలను నిర్వచిస్తాను. దీనివల్ల విండో పరిమాణం మారినప్పటికీ బటన్‌లు సరిగ్గా అమర్చబడి ఉంటాయి.

ఈ సిస్టమ్ ఒక సాధారణ స్టేట్ మెషీన్‌ను ఉపయోగిస్తుంది. ప్రతి స్క్రీన్‌కు ఇవి ఉంటాయి:

  • ఒక ఇమేజ్ ID
  • హాట్‌స్పాట్‌ల జాబితా
  • ఒక టార్గెట్ డెస్టినేషన్

నేను రూపొందించిన టూల్స్

కంటితో కోఆర్డినేట్‌లను కొలవడం నెమ్మదిగా ఉంటుంది. ఈ ప్రక్రియను వేగవంతం చేయడానికి నేను ఒక స్టాండ్‌అలోన్ HTML ఎడిటర్‌ను రూపొందించాను.

  • కాన్వాస్‌కు ఒక స్క్రీన్‌షాట్‌ను అప్‌లోడ్ చేయండి.
  • దీర్ఘచతురస్రాన్ని గీయడానికి మీ మౌస్‌ను డ్రాగ్ చేయండి.
  • ఎడిటర్ పర్సెంటేజ్ కోఆర్డినేట్‌లను ఆటోమేటిక్‌గా లెక్కిస్తుంది.
  • డ్రాప్‌డౌన్ ద్వారా ఆ ప్రాంతాన్ని మరొక స్క్రీన్‌కు లింక్ చేయండి.
  • ఫైనల్ ఆబ్జెక్ట్‌ను నేరుగా మీ కోడ్‌లోకి ఎగుమతి (export) చేయండి.

వినియోగదారులకు సహాయపడటానికి, క్లిక్ చేయగల ప్రాంతాలకు నేను పల్సింగ్ బ్లూ గ్లో (pulsing blue glow)ను జోడించాను. దీనివల్ల వారు ఎక్కడ ట్యాప్ చేయవచ్చో స్పష్టంగా తెలుస్తుంది.

ముఖ్యమైన సాంకేతిక పాఠాలు

  1. Firebase Security: స్టోరేజ్ URLలను మాన్యువల్‌గా నిర్మించవద్దు. SDK నుండి getDownloadURL మెథడ్‌ను ఉపయోగించండి. ఇందులో అవసరమైన auth టోకెన్ ఉంటుంది. అది లేకపోతే, ఎటువంటి ఎర్రర్ చూపించకుండానే చిత్రాలు లోడ్ అవ్వవు.

  2. Layout Fixes: ఫ్లెక్స్ కాలమ్ లేఅవుట్‌లో, పేరెంట్‌కు స్పష్టమైన ఎత్తును (explicit height) సెట్ చేయండి. చైల్డ్రన్స్‌కు min-heightను 0గా సెట్ చేయండి. ఇది లేఅవుట్ కుప్పకూలడం (collapse) మరియు ఓవర్‌ఫ్లో సమస్యలను నివారిస్తుంది.

  3. Scaling: CSS transform scale ప్రాపర్టీని ఉపయోగించండి. ఇది ఇమేజ్ మరియు హాట్‌స్పాట్‌లు కలిసి రీసైజ్ అయ్యేలా చేస్తుంది. దీనివల్ల స్క్రీన్ పరిమాణంతో సంబంధం లేకుండా అంతా నిష్పత్తిలో (proportion) ఉంటుంది.

  4. Speed: URLలను ఒక్కొక్కటిగా ఫెచ్ చేయడం వల్ల లాగ్ (lag) ఏర్పడుతుంది. నేను ఇన్‌-మెమరీ క్యాష్ మరియు బ్యాక్‌గ్రౌండ్ ప్రీలోడ్ ఫంక్షన్‌ను అమలు చేశాను. మోడల్ ఓపెన్ అయినప్పుడు అన్ని చిత్రాలు సమాంతరంగా (in parallel) లోడ్ అవుతాయి. ఇది నావిగేషన్‌ను ఇన్‌స్టంట్‌గా చేస్తుంది.

ఫలితం

  • పూర్తి నావిగేషన్‌తో 20 స్క్రీన్‌లు.
  • 52 ఇంటరాక్టివ్ హాట్‌స్పాట్‌లు.
  • ఆటో-స్కేలింగ్ వల్ల స్క్రోల్‌బార్‌లు లేవు.
  • ప్రీలోడింగ్ ద్వారా ఇన్‌స్టంట్‌గా ట్రాన్సిషన్లు.

మూలం: https://dev.to/androve2k/building-an-interactive-app-guide-with-clickable-hotspots-on-real-screenshots-o9e