Как задать имя установщика лаунчера

Как это работает

По умолчанию файлы установщика лаунчера называются installer.exe для автономной версии и web_installer.exe — для веб-версии. Вы можете задать собственное название в коде вашего сайта. Когда пользователь нажмет кнопку или ссылку для скачивания, имя установочного файла автоматически заменится браузером.

Как настроить

  1. Добавьте в код вашего сайта невидимый для пользователя iframe, внутри которого будет формироваться ссылка на скачивание установочного файла с измененным названием, как показано в примере ниже.

Пример:

Copy
Full screen
Small screen
     1<body>
     2  ...
     3  <script>
     4    const frame = document.createElement("IFRAME");
     5    frame.id = "xsolla-installer-renamer";
     6    frame.src = `https://installer.launcher.xsolla.com/launcher-installer-renamer-prod/v1/renamer.html?cache=${Date.now()}`;
     7    frame.style = "display: none";
     8    document.body.append(frame);
     9  </script>
    10  ...
    11<body>
    

    1. Реализуйте вызов метода postMessage(), который по нажатию на ссылку или кнопку передаст в iframe параметры:
      • <LINK TO INSTALLER> — URL-адрес установочного файла. Вы можете найти его в разделе Launcher > Настройки > Сборка лаунчера Личного кабинета. Пример: https://installer.launcher.xsolla.com/xlauncher-builds/xsolla-launcher-update/123456789/bin/web_installer.exe
      • <NEW INSTALLER NAME> — имя установочного файла.

    Пример:

    Copy
    Full screen
    Small screen
      1postMessage(
      2  {
      3    type: "download",
      4    href: "<LINK TO INSTALLER>",
      5    name: "<NEW INSTALLER NAME>",
      6  },
      7  "https://installer.launcher.xsolla.com"
      8)
      

      Ниже приведены примеры кода ссылки и кнопки для скачивания установочного файла.

      Пример кода ссылки для скачивания установочного файла:

      Copy
      Full screen
      Small screen
         1<body>
         2  ...
         3  <a
         4      href="#"
         5      onclick="document.getElementById('xsolla-installer-renamer').contentWindow.postMessage({ type: 'download', href: '<LINK TO INSTALLER>', name: '<NEW INSTALLER NAME>' }, 'https://installer.launcher.xsolla.com');"
         6  >
         7    Donwload
         8  </a>
         9  ...
        10<body>
        

        Пример кода кнопки для скачивания установочного файла:

        Copy
        Full screen
        Small screen
           1<body>
           2  ...
           3  <button id="button-download">Download</button>
           4  <script>
           5    const btn = document.getElementById("button-download");
           6    btn.onclick = () => {
           7      document
           8        .getElementById("xsolla-installer-renamer")
           9        .contentWindow.postMessage(
          10          {
          11            type: "download",
          12            href: "<LINK TO INSTALLER>",
          13            name: "<NEW INSTALLER NAME>",
          14          },
          15          "https://installer.launcher.xsolla.com"
          16        );
          17    };
          18  </script>
          19  ...
          20<body>
          
          Была ли статья полезна?
          Спасибо!
          Что может сделать страницу еще лучше? Сообщение
          Жаль, что так произошло
          Расскажите, почему статья не была полезна. Сообщение
          Спасибо за обратную связь!
          Ваши мысли и идеи помогут нам улучшить ваш пользовательский опыт.
          Последнее обновление: 22 января 2024

          Нашли опечатку или ошибку в тексте? Выделите ее и нажмите Ctrl+Enter.

          Сообщите о проблеме
          Мы постоянно улучшаем качество нашей документации. Ваш отзыв поможет нам в этом.
          Укажите email-адрес, чтобы мы могли связаться с вами
          Спасибо за обратную связь!
          Не получилось отправить ваш комментарий
          Попробуйте еще раз позже или напишите нам на [email protected].
          OSZAR »