מדריך פריסה ותצורה ל-IT

מסמך זה מיועד למנהל IT שצריך להתקין את HoverSpeak בכפייה במכשירי מוסדות חינוך, בכיתות, במעבדות או בחשבונות תלמידים מנוהלים.

דרישות קדם לפריסה

• גרסאות דפדפן: Chrome 109+ או Edge 109+ עבור התוסף הנוכחי. HoverSpeak משתמש במסמכי Manifest V3 מחוץ למסך דרך API ‏chrome.offscreen, הדורש Chrome 109+ / MV3+. תכונת הגדרות המילים האופציונלית דורשת Chrome 148+ משום שהיא נשענת על יכולת ה-AI המקומית החדשה של Chrome; Microsoft Edge אינו תומך כרגע בתכונה זו.
• הרשאות הנדרשות לתוסף:
  • storage (includes managed storage via the schema below)
  • tts
  • scripting
  • offscreen
  • activeTab
  • הרשאות מארח: <all_urls>
• רשומת סכמה מנוהלת ב-manifest.json:

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

מודל מדיניות מנוהלת

• מדיניות מוגדרת ב-schema.json ונקראת דרך chrome.storage.managed.
• הערכים בפועל נקבעים בסדר הבא:
  1. מדיניות מנוהלת
  2. העדפת משתמש מסונכרנת
  3. ברירת מחדל מובנית
• מפתחות המדיניות לקיצורי דרך הם להכוונה בלבד. ReadShortcutWindows, StopShortcutWindows, PauseShortcutWindows, ReadShortcutMac, StopShortcutMac ו-PauseShortcutMac מעדכנים את רמזי הקיצורים שמוצגים ב-HoverSpeak, אך אינם כופים קיצורי מקלדת ב-Chrome או ב-Edge.
• זיהוי הגדרה מנוהלת: HoverSpeak מתייחס להגדרה כמנוהלת כאשר התוסף מותקן על ידי מנהל מערכת או כאשר קיים לפחות מפתח מדיניות מנוהלת אחד. ההגדרות ננעלות רק כאשר מפתח המדיניות המתאים מוגדר.

התקנת כפייה שלב אחר שלב

Google Admin Console (Chrome)

1. עברו אל מסוף הניהול ← מכשירים ← Chrome ← אפליקציות ותוספים ← משתמשים ודפדפנים.
2. בחרו את היחידה הארגונית (OU) היעד.
3. לחצו על + והוסיפו את התוסף לפי מזהה:
   • Chrome Web Store ID: kpkdjcalihjnkemhkdlciiekkmooglmb
4. הגדירו את מדיניות ההתקנה ל-התקנת כפייה.
5. פתחו את פרטי התוסף ולאחר מכן הגדירו מדיניות ← אחסון מנוהל עם payload ה-JSON מסעיף המדיניות שבהמשך.
6. החילו את המדיניות על ה-OU והמתינו להפצתה.

אימות:

• במכשיר יעד, פתחו את chrome://policy ולחצו על טעינת מדיניות מחדש.
• ודאו שהתוסף מופיע ב-chrome://extensions.

Microsoft Intune (Edge)

1. ב-Microsoft Intune, עברו אל מכשירים ← פרופילי תצורה וצרו או ערכו פרופיל עבור Windows 10 ואילך.
2. השתמשו ב-קטלוג ההגדרות והוסיפו את ההגדרה הזו:
   • Microsoft Edge ← תוספים ← הגדרת אפשרויות ניהול תוספים.
3. הוסיפו רשומת התקנת כפייה עבור Edge באמצעות מזהה החנות:
   • Edge Add-ons ID: omibkefgmhnhfboefblahmjdcgapoeea
   • כתובת URL לעדכון: https://edge.microsoft.com/extensionwebstorebase/v1/crx
4. הוסיפו את payload ה-JSON של האחסון המנוהל מסעיף המדיניות לבלוק התצורה של התוסף.
5. שייכו את הפרופיל לקבוצת מכשירי היעד.

אימות:

• במכשיר יעד, פתחו את edge://policy ולחצו על טעינת מדיניות מחדש.
• ודאו שהתוסף מופיע ב-edge://extensions.

סכמת מדיניות מנוהלת (chrome.storage.managed)

סכמת המדיניות המנוהלת נמצאת ב-schema.json ונקראת על ידי ה-service worker דרך chrome.storage.managed.

הפניה למפתחות מדיניות

כל המפתחות שייכים למרחב השמות של מדיניות התוסף וממופים אל 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."
    }
  }
}

דוגמת payload לאחסון מנוהל

השתמשו ב-JSON זה באזור האחסון המנוהל של Admin Console או 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"
}

דוגמאות מדיניות נפוצות

• השתמשו ב-EnableCloudVoices כדי לאפשר או לחסום קולות ענן. הגדירו false כדי לכפות קולות מקומיים בלבד.
• כדי להציג מיתוג בהגדרות התוסף, הגדירו OrganizationName ואופציונלית OrganizationUrl כדי להציג HoverSpeak provided by <name>.
• הגדירו WordByWordHighlightingEnabled כדי לנעול את Word-by-Word פעיל או כבוי. הסף נשאר העדפת משתמש וברירת המחדל היא יותר מ-40 מילים.
• השתמשו ב-ReadShortcut*, StopShortcut* ו-PauseShortcut* כרמזי קיצור מוצגים בלבד. שיוכי הקיצורים בדפדפן נשארים בשליטת Chrome או Edge.

הערות פריסה לפי פלטפורמה

נתיב רישום Windows (Chrome)

בפריסות Chrome מחוץ ל-Google Admin Console, Windows קורא את מדיניות התוסף מנתיב הרישום הבא:

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

• החליפו את <EXTENSION_ID> במזהה תוסף HoverSpeak מתוך chrome://extensions.
• השתמשו ב-DWORD (32-bit) עבור מפתחות בוליאניים.
• השתמשו ב-REG_SZ עבור מפתחות טקסט.
• לאחר ביצוע שינויים, הפעילו מחדש את Chrome וטענו מחדש את chrome://policy.

פרופילים מנוהלים של macOS

ב-macOS, מדיניות HoverSpeak נמסרת דרך פרופילי תצורה מנוהלים של Chrome. השתמשו במזהה החבילה הנכון של Chrome ובמרחב השמות של מדיניות התוסף, ואז טענו מחדש את chrome://policy כדי לוודא שהפרופיל פעיל.

רשימת אימות

• טענו מחדש את chrome://policy או edge://policy וודאו שרשומת המדיניות אינה מציגה שגיאות ניתוח או סוג.
• ודאו שהתוסף קיים ומעודכן ב-chrome://extensions או edge://extensions.
• פתחו את הגדרות HoverSpeak וודאו שהבקרות המנוהלות נעולות במקום שבו הוגדרה מדיניות.
• ודאו שתיאורי עזרה או תוויות מנוהלות מוצגים עבור בקרות נעולות.
• ודאו ש-WordByWordHighlightingEnabled=true נועל את Word-by-Word פעיל בעוד שסף המילים העצמאי נשאר ניתן לעריכה.
• ודאו שהטקסט הנבחר חייב לעבור את סף Word-by-Word שהוגדר, שברירת המחדל שלו היא יותר מ-40 מילים.
• ודאו ש-HideDonationAndRating=true מסיר את אזור התרומה והדירוג.
• ודאו ש-EnableCloudVoices=false משאיר את קולות הענן מושבתים.
• ודאו שהתנהגות הדף משקפת את ההגדרות המנוהלות בעת טעינת הדף ולאחר רענון מדיניות.
• ודאו שמיתוג הארגון מופיע כאשר OrganizationName מוגדר.
• בפריסות מנוהלות, ודאו שהתנהגות ההטמעה המנוהלת מוחלת גם כאשר התוסף הותקן על ידי מנהל מערכת ללא מפתחות אחסון מנוהל מפורשים.
• בהתקנות רגילות, ודאו שהתנהגות ההטמעה המנוהלת מוחלת כאשר קיים לפחות מפתח מדיניות מנוהלת אחד.

פתרון בעיות

• המדיניות אינה מוחלת: פתחו את chrome://policy או edge://policy, לחצו על טעינת מדיניות מחדש, וודאו שאין שגיאות ברשומת מדיניות התוסף.
• התוסף חסר לאחר התקנת כפייה: ודאו שנעשה שימוש במזהה החנות ובכתובת העדכון הנכונים ושהפרופיל משויך ל-OU או לקבוצת המכשירים הנכונה.
• ערכים מנוהלים מתעלמים: ודאו ששמות המפתחות תואמים בדיוק לסכמה ושסוגי JSON תואמים לסכמה; ערכים בוליאניים חייבים להיות true/false ומחרוזות חייבות להיות במרכאות.
• הערכים המנוהלים עדיין נראים מיושנים: ודאו שהתוסף עודכן, שה-service worker פעיל, ושהדפדפן הופעל מחדש אם השתנו ערכי רישום או פרופיל.
• קולות ענן עדיין זמינים לאחר השבתה: ודאו ש-EnableCloudVoices מוגדר ל-false ושהמדיניות מוצגת כמנוהלת ב-chrome://policy או edge://policy.

תמיכה בעדיפות: פרטי הקשר לתמיכה בעדיפות כלולים בחבילת ההטמעה של מוסד החינוך שלכם.