Guide för IT-driftsättning och konfiguration

Detta dokument är för IT-administratören som behöver tvinga installation av HoverSpeak på utbildningsinstitutionens enheter, i klassrum, labb eller hanterade elevkonton.

Förutsättningar för driftsättning

• Webbläsarversioner: Chrome 109+ eller Edge 109+ för den aktuella tillägget. HoverSpeak använder Manifest V3-offscreen-dokument via API:et chrome.offscreen, vilket kräver Chrome 109+ / MV3+. Den valfria funktionen för orddefinitioner kräver Chrome 148+ eftersom den bygger på Chromes nyare lokala AI-funktion; Microsoft Edge stöder för närvarande inte den funktionen.
• Behörigheter som krävs av tillägget:
  • storage (includes managed storage via the schema below)
  • tts
  • scripting
  • offscreen
  • activeTab
  • Värdbehörigheter: <all_urls>
• Post för hanterat schema i manifest.json:

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

Modell för hanterad policy

• 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
• Policynycklar för genvägar är endast vägledande. ReadShortcutWindows, StopShortcutWindows, PauseShortcutWindows, ReadShortcutMac, StopShortcutMac och PauseShortcutMac uppdaterar genvägstipsen som HoverSpeak visar, men tvingar inte tangentbordsgenvägar i Chrome eller Edge.
• Identifiering av hanterad konfiguration: HoverSpeak behandlar konfigurationen som hanterad när tillägget installeras av administratör eller när minst en hanterad policynyckel finns. Inställningar låses bara när motsvarande policynyckel faktiskt är satt.

Tvingad installation steg för steg

Google Admin Console (Chrome)

1. Gå till Administratörskonsolen → Enheter → Chrome → Appar och tillägg → Användare och webbläsare.
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. Öppna tilläggsinformationen och konfigurera sedan Policy → Hanterad lagring med JSON-payloaden från policyavsnittet nedan.
6. Tillämpa policyn på OU:n och vänta på spridning.

Validering:

• Öppna chrome://policy på en målenhet och klicka på Läs in policyer igen.
• Bekräfta att tillägget finns i chrome://extensions.

Microsoft Intune (Edge)

1. I Microsoft Intune, gå till Enheter → Konfigurationsprofiler och skapa eller redigera en profil för Windows 10 och senare.
2. Använd Inställningskatalogen och lägg till den här inställningen:
   • Microsoft Edge → Tillägg → Konfigurera inställningar för tilläggshantering.
3. Lägg till en tvingad installationspost för Edge med store-ID:t:
   • Edge Add-ons ID: omibkefgmhnhfboefblahmjdcgapoeea
   • Uppdaterings-URL: https://edge.microsoft.com/extensionwebstorebase/v1/crx
4. Lägg till JSON-payloaden för hanterad lagring från policyavsnittet i tilläggets konfigurationsblock.
5. Tilldela profilen till målgruppen för enheter.

Validering:

• Öppna edge://policy på en målenhet och klicka på Läs in policyer igen.
• Bekräfta att tillägget finns i edge://extensions.

Schema för hanterad policy (chrome.storage.managed)

Schemat för hanterad policy finns i schema.json och läses av service workern via chrome.storage.managed.

Referens för policynycklar

Alla nycklar hör till tilläggets policynamnrymd och mappar till 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."
    }
  }
}

Exempel på hanterad lagringspayload

Använd denna JSON i området för hanterad lagring 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"
}

Vanliga policyexempel

• Använd EnableCloudVoices för att tillåta eller blockera molnröster. Sätt false för att tvinga endast lokala röster.
• För branding i tilläggets inställningar, sätt OrganizationName och eventuellt OrganizationUrl för att visa HoverSpeak provided by <name>.
• Sätt WordByWordHighlightingEnabled för att låsa Word-by-Word på eller av. Tröskeln förblir en användarinställning och är som standard mer än 40 ord.
• Använd ReadShortcut*, StopShortcut* och PauseShortcut* endast som visade genvägstips. Webbläsarens tilldelningar styrs fortfarande av Chrome eller Edge.

Plattformsspecifika driftsättningsanteckningar

Windows-registersökväg (Chrome)

För Chrome-driftsättningar utanför Google Admin Console läser Windows tilläggspolicyn från registersökvägen nedan:

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

• Ersätt <EXTENSION_ID> med HoverSpeak-tilläggets ID från chrome://extensions.
• Använd DWORD (32-bit) för booleska nycklar.
• Använd REG_SZ för strängnycklar.
• Efter ändringar, starta om Chrome och läs in chrome://policy igen.

Hanterade macOS-profiler

På macOS levereras HoverSpeak-policyer via hanterade Chrome-konfigurationsprofiler. Använd rätt Chrome bundle-ID och tilläggets policynamnrymd och läs sedan in chrome://policy igen för att bekräfta att profilen är aktiv.

Valideringschecklista

• Läs in chrome://policy eller edge://policy igen och bekräfta att policyposten inte visar tolknings- eller typfel.
• Bekräfta att tillägget finns och är uppdaterat i chrome://extensions eller edge://extensions.
• Öppna HoverSpeak-inställningarna och bekräfta att hanterade kontroller är låsta där policy är satt.
• Bekräfta att hanterade verktygstips eller etiketter visas för låsta kontroller.
• Kontrollera att WordByWordHighlightingEnabled=true låser Word-by-Word på medan den separata ordtröskeln fortfarande kan redigeras.
• Kontrollera att markerad text måste överstiga den konfigurerade Word-by-Word-tröskeln, som som standard är mer än 40 ord.
• Kontrollera att HideDonationAndRating=true tar bort donations- och betygsområdet.
• Kontrollera att EnableCloudVoices=false håller molnröster inaktiverade.
• Kontrollera att sidans beteende återspeglar hanterade inställningar vid sidladdning och efter policyuppdatering.
• Kontrollera att organisationsbranding visas när OrganizationName är konfigurerat.
• För hanterade utrullningar, bekräfta att hanterad onboarding tillämpas även när tillägget är administratörsinstallerat utan explicita nycklar för hanterad lagring.
• För vanliga installationer, bekräfta att hanterad onboarding tillämpas när minst en hanterad policynyckel finns.

Felsökning

• Policy tillämpas inte: öppna chrome://policy eller edge://policy, klicka på Läs in policyer igen och kontrollera att inga fel visas på tilläggets policypost.
• Tillägget saknas efter tvingad installation: kontrollera att rätt store-ID och uppdaterings-URL användes och att profilen är tilldelad rätt OU eller enhetsgrupp.
• Hanterade värden ignoreras: bekräfta att nyckelnamnen exakt matchar schemat och att JSON-typerna matchar schemat; booleska värden måste vara true/false och strängar måste vara citerade.
• Hanterade värden verkar fortfarande gamla: bekräfta att tillägget har uppdaterats, service workern är aktiv och webbläsaren har startats om om register- eller profilvärden ändrats.
• Molnröster är fortfarande tillgängliga efter inaktivering: säkerställ att EnableCloudVoices är satt till false och att policyn visas som hanterad i chrome://policy eller edge://policy.

Prioriterad support: Kontaktinformation för prioriterad support ingår i onboardingpaketet för er utbildningsinstitution.