Vejledning til IT-udrulning og konfiguration

Dette dokument er til IT-administratoren, der skal tvangsinstallere HoverSpeak på uddannelsesinstitutioners enheder, i klasseværelser, laboratorier eller administrerede elevkonti.

Forudsætninger for udrulning

• Browser-versioner: Chrome 109+ eller Edge 109+ til den aktuelle udvidelse. HoverSpeak bruger Manifest V3-offscreen-dokumenter via chrome.offscreen-API’en, som kræver Chrome 109+ / MV3+. Den valgfrie ordforklaringsfunktion kræver Chrome 148+, fordi den bygger på Chromes nyere lokale AI-funktion; Microsoft Edge understøtter i øjeblikket ikke denne funktion.
• Tilladelser krævet af udvidelsen:
  • storage (includes managed storage via the schema below)
  • tts
  • scripting
  • offscreen
  • activeTab
  • Værtstilladelser: <all_urls>
• Administreret skemapost i manifest.json:

{
  "storage": {
    "managed_schema": "schema.json"
  }
}

Model for administreret politik

• Policyer definieras i schema.json och läses via chrome.storage.managed.
• Effektiva värden avgörs i denna ordning:
  1. Hanterad policy
  2. Synkroniserad användarinställning
  3. Inbyggt standardvärde
• Politiknøgler til genveje er kun vejledende. ReadShortcutWindows, StopShortcutWindows, PauseShortcutWindows, ReadShortcutMac, StopShortcutMac og PauseShortcutMac opdaterer de genvejstips, som HoverSpeak viser, men de gennemtvinger ikke tastaturgenveje i Chrome eller Edge.
• Registrering af administreret opsætning: HoverSpeak behandler opsætningen som administreret, når udvidelsen er installeret af en administrator, eller når mindst én administreret politiknøgle findes. Indstillinger låses kun, når den tilsvarende politiknøgle faktisk er sat.

Tvangsinstallation trin for trin

Google Admin Console (Chrome)

1. Gå til Administrationskonsol → Enheder → Chrome → Apps og udvidelser → Brugere og browsere.
2. Välj målorganisationsenheten (OU).
3. Klicka på + och lägg till tillägget med ID:
   • Chrome Web Store ID: kpkdjcalihjnkemhkdlciiekkmooglmb
4. Ställ in installationspolicyn på Tvingad installation.
5. Åbn udvidelsesdetaljerne, og konfigurer derefter Politik → Administreret lager med JSON-payloaden fra politikafsnittet nedenfor.
6. Tillämpa policyn på OU:n och vänta på spridning.

Validering:

• Åbn chrome://policy på en målenhed, og klik på Genindlæs politikker.
• Bekräfta att tillägget finns i chrome://extensions.

Microsoft Intune (Edge)

1. I Microsoft Intune skal du gå til Enheder → Konfigurationsprofiler og oprette eller redigere en profil for Windows 10 og nyere.
2. Brug Indstillingskatalog, og tilføj denne indstilling:
   • Microsoft Edge → Udvidelser → Konfigurer indstillinger for udvidelsesstyring.
3. Tilføj en tvangsinstallationspost for Edge med store-id'et:
   • Edge Add-ons ID: omibkefgmhnhfboefblahmjdcgapoeea
   • Opdaterings-URL: https://edge.microsoft.com/extensionwebstorebase/v1/crx
4. Tilføj JSON-payloaden for administreret lager fra politikafsnittet til udvidelsens konfigurationsblok.
5. Tildel profilen til målgruppen af enheder.

Validering:

• Åbn edge://policy på en målenhed, og klik på Genindlæs politikker.
• Bekräfta att tillägget finns i edge://extensions.

Skema for administreret politik (chrome.storage.managed)

Skemaet for administreret politik findes i schema.json og læses af service workeren via chrome.storage.managed.

Reference for politiknøgler

Alle nøgler hører til udvidelsens politiknavneområde og mapper til schema.json.

{
  "type": "object",
  "properties": {
    "EnableCloudVoices": {
      "type": "boolean",
      "description": "If false, cloud voices remain disabled by policy."
    },
    "OrganizationName": {
      "type": "string",
      "description": "Displays the educational institution, district, or program name in the extension settings interface."
    },
    "OrganizationUrl": {
      "type": "string",
      "description": "Link target for the organization name in the extension settings interface."
    },
    "FollowMouse": {
      "type": "boolean",
      "description": "If true, always highlight text under the mouse."
    },
    "AutoSwitchLanguage": {
      "type": "boolean",
      "description": "Automatically switch language to match the language of the page."
    },
    "ShowLanguageToast": {
      "type": "boolean",
      "description": "Display a message when language switches."
    },
    "WordByWordHighlightingEnabled": {
      "type": "boolean",
      "description": "If false, disables Word-by-Word highlighting for long selected text."
    },
    "ReadShortcutWindows": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Start reading command on Windows."
    },
    "StopShortcutWindows": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Stop reading command on Windows."
    },
    "PauseShortcutWindows": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Pause / Continue command on Windows."
    },
    "ReadShortcutMac": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Start reading command on macOS."
    },
    "StopShortcutMac": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Stop reading command on macOS."
    },
    "PauseShortcutMac": {
      "type": "string",
      "description": "Admin-defined shortcut hint for the Pause / Continue command on macOS."
    },
    "HideDonationAndRating": {
      "type": "boolean",
      "description": "If true, hides the donation and rating area."
    }
  }
}

Eksempel på administreret lagerpayload

Brug denne JSON i området for administreret lager i Admin Console eller Intune:

{
  "EnableCloudVoices": false,
  "OrganizationName": "Westside Learning Center",
  "OrganizationUrl": "https://www.westside.edu",
  "FollowMouse": true,
  "AutoSwitchLanguage": true,
  "ShowLanguageToast": false,
  "WordByWordHighlightingEnabled": true,
  "HideDonationAndRating": true,
  "ReadShortcutWindows": "Alt+Z",
  "StopShortcutWindows": "Alt+X",
  "PauseShortcutWindows": "Alt+C",
  "ReadShortcutMac": "Option+Z",
  "StopShortcutMac": "Option+X",
  "PauseShortcutMac": "Option+C"
}

Almindelige politikeksempler

• Brug EnableCloudVoices til at tillade eller blokere cloudstemmer. Sæt false for kun at tillade lokale stemmer.
• For branding i udvidelsens indstillinger skal du sætte OrganizationName og eventuelt OrganizationUrl for at vise HoverSpeak provided by <name>.
• Sæt WordByWordHighlightingEnabled for at låse Word-by-Word til eller fra. Grænsen er fortsat en brugerindstilling og er som standard mere end 40 ord.
• Brug ReadShortcut*, StopShortcut* og PauseShortcut* kun som viste genvejstips. Browserens genvejstildelinger styres fortsat af Chrome eller Edge.

Platformsspecifikke udrulningsnoter

Windows-registreringssti (Chrome)

Ved Chrome-udrulninger uden for Google Admin Console læser Windows udvidelsespolitikken fra registreringsstien nedenfor:

HKEY_CURRENT_USER\Software\Policies\Google\Chrome\3rdparty\extensions\<EXTENSION_ID>\policy

• Erstat <EXTENSION_ID> med HoverSpeak-udvidelses-id'et fra chrome://extensions.
• Brug DWORD (32-bit) til booleske nøgler.
• Brug REG_SZ til tekstnøgler.
• Efter ændringer skal du genstarte Chrome og genindlæse chrome://policy.

Administrerede macOS-profiler

På macOS leveres HoverSpeak-politikker via administrerede Chrome-konfigurationsprofiler. Brug den korrekte Chrome bundle-id og udvidelsens politiknavneområde, og genindlæs derefter chrome://policy for at bekræfte, at profilen er aktiv.

Valideringstjekliste

• Genindlæs chrome://policy eller edge://policy, og bekræft, at politikposten ikke viser parse- eller typefejl.
• Bekræft, at udvidelsen findes og er opdateret i chrome://extensions eller edge://extensions.
• Åbn HoverSpeak-indstillingerne, og bekræft, at administrerede kontroller er låst, hvor politikken er sat.
• Bekræft, at administrerede hjælpetekster eller etiketter er synlige for låste kontroller.
• Kontrollér, at WordByWordHighlightingEnabled=true låser Word-by-Word til, mens den separate ordgrænse fortsat kan redigeres.
• Kontrollér, at markeret tekst skal overstige den konfigurerede Word-by-Word-grænse, som som standard er mere end 40 ord.
• Kontrollér, at HideDonationAndRating=true fjerner donations- og vurderingsområdet.
• Kontrollér, at EnableCloudVoices=false holder cloudstemmer deaktiveret.
• Kontrollér, at sideadfærd afspejler de administrerede indstillinger ved indlæsning og efter en politikopdatering.
• Kontrollér, at organisationsbranding vises, når OrganizationName er konfigureret.
• Ved administrerede udrulninger skal du bekræfte, at administreret onboarding anvendes, selv når udvidelsen er installeret af administratoren uden eksplicitte nøgler til administreret lager.
• Ved normale installationer skal du bekræfte, at administreret onboarding anvendes, når mindst én administreret politiknøgle findes.

Fejlfinding

• Politikken anvendes ikke: Åbn chrome://policy eller edge://policy, klik på Genindlæs politikker, og kontrollér, at der ikke vises fejl på udvidelsens politikpost.
• Udvidelsen mangler efter tvangsinstallation: Kontrollér, at korrekt store-id og opdaterings-URL blev brugt, og at profilen er tildelt den rigtige OU eller enhedsgruppe.
• Administrerede værdier ignoreres: Bekræft, at nøglenavne matcher skemaet nøjagtigt, og at JSON-typerne matcher skemaet; booleske værdier skal være true/false, og strenge skal være i anførselstegn.
• Administrerede værdier virker stadig forældede: Bekræft, at udvidelsen er opdateret, service workeren er aktiv, og browseren er genstartet, hvis registrerings- eller profilværdier er ændret.
• Cloudstemmer er stadig tilgængelige efter deaktivering: Sørg for, at EnableCloudVoices er sat til false, og at politikken vises som administreret i chrome://policy eller edge://policy.

Prioriteret support: Kontaktoplysninger til prioriteret support er inkluderet i onboardingpakken til jeres uddannelsesinstitution.