Инструменты пользователя

Инструменты сайта


help:qspider

Различия

Здесь показаны различия между двумя версиями данной страницы.

Ссылка на это сравнение

Both sides previous revision Предыдущая версия
Следущая версия
Предыдущая версия
help:qspider [2024/03/12 09:17]
aleks_versus [Установка и запуск плеера на компьютере]
help:qspider [2024/10/15 10:08] (текущий)
aleks_versus
Строка 3: Строка 3:
 ====== qSpider — плеер с поддержкой HTML ====== ====== qSpider — плеер с поддержкой HTML ======
  
-Статья актуализирована для qSpider версии ​0.13.0.+Статья актуализирована для qSpider версии ​1.3.1.
  
 ===== Общие сведения ===== ===== Общие сведения =====
Строка 9: Строка 9:
 **qSpider** — это QSP-плеер с поддержкой полноценной браузерной HTML-вёрстки,​ то есть в нём можно использовать такой же HTML-код,​ как в обычном браузере. **qSpider** — это QSP-плеер с поддержкой полноценной браузерной HTML-вёрстки,​ то есть в нём можно использовать такой же HTML-код,​ как в обычном браузере.
  
-Обучиться писать HTML-разметку можно, например,​ здесь: [[https://​htmlacademy.ru|https://htmlacademy.ru]]. +Обучиться писать HTML-разметку можно, например,​ здесь: 
-Справочник актуальных HTML-тегов,​ CSS-свойств,​ самоучители и прочее:​ [[https://​htmlbook.ru|https://htmlbook.ru]]+  * [[https://​htmlacademy.ru|htmlacademy.ru]]. 
 +  ​* ​Справочник актуальных HTML-тегов,​ CSS-свойств,​ самоучители и прочее:​ [[https://​htmlbook.ru|htmlbook.ru]]
  
 Cуществует два варианта плеера:​ Cуществует два варианта плеера:​
- * десктопный вариант (для стационарных компьютеров,​ запускается без браузера);​ 
- * браузерный вариант (запускается непосредственно в браузере,​ и потому данный вариант можно использовать,​ например,​ для публикации игр на QSP в интернете). 
  
-Изначально ​**qSpider** разрабатывался для поддержки AeroQSP-игр (так как ​технология flash прекратила своё существование), однако позже был переориентирован в основном на поддержку классических игр. Возможность запуска ​игр AeroQSP ​сохраниласьхотя для ​их полноценной работы может понадобиться небольшая правка.+  ​десктопный вариант ля стационарных ​компьютеров, запускается ​без браузера); 
 +  * браузерный вариант ​(запускается непосредственно в браузере, и потому данный вариант можно использоватьнапример, для публикации игр на QSP в интернете).
  
 Релиз последней версии плеера **qSpider** вы всегда можете найти по этой ссылке:​ Релиз последней версии плеера **qSpider** вы всегда можете найти по этой ссылке:​
  
-[[https://​github.com/​qspfoundation/​qspider/​releases|https://​github.com/​qspfoundation/​qspider/​releases]]+[[https://​github.com/​qspfoundation/​qspider/​releases]]
  
 **qSpider** использует последнюю версию библиотеки ''​qsplib'',​ а значит игры, написанные на классический плеер с той же версией библиотеки,​ полностью совместимы с **qSpider**. **qSpider** использует последнюю версию библиотеки ''​qsplib'',​ а значит игры, написанные на классический плеер с той же версией библиотеки,​ полностью совместимы с **qSpider**.
  
 Демонстрацию работы плеера можно посмотреть здесь: Демонстрацию работы плеера можно посмотреть здесь:
-    ​* [[https://​qspfoundation.github.io/​qspider|https://​qspfoundation.github.io/​qspider]]. qSpider откроется в браузере и прямо в нём вы сможете просмотреть каталог игр, представленных на сайте qsp.org, добавить любую из них на полку и поиграть. + 
-    * [[https://​aleksversus.github.io/​merphy_law/​|"​Вереница миров"​]] — стандалон сборка игры онлайн на плеере qSpider.+  * Поиграть в QSP-игры без установки плеера:​ **[[https://​qspfoundation.github.io/​qspider/​|qspfoundation.github.io/​qspider]]****qSpider** откроется в браузере и прямо в нём вы сможете просмотреть каталог игр, представленных на сайте qsp.org, добавить любую из них на полку и поиграть. 
 +  * **[[https://​aleksversus.github.io/​merphy_law/​|"​Вереница миров"​]]** — стандалон сборка игры онлайн на плеере ​**qSpider**. 
 ===== Отличия qSpider от Классического плеера:​ ===== ===== Отличия qSpider от Классического плеера:​ =====
  
- * Полноценная поддержка HTML, как в браузере,​ в том числе встраивание видео(!);​ +  * **Полноценная поддержка HTML**, как в браузере,​ в том числе встраивание видео(!);​ 
- * Есть доступ к панели разработчика,​ позволяющей контролировать корректность HTML-вёрстки;​ +  * Есть ​**доступ к панели разработчика**, позволяющей контролировать корректность HTML-вёрстки;​ 
- * Пути к ресурсам (картинкам/​аудио файлам) регистрозависимы — то есть, если файл называется "''​image.jpg''",​ а в файле игры записано "''​Image.jpg''"​ или "''​image.JPG''",​ то плеер не сможет показать такую картинку;​ +  * **Пути к ресурсам** (картинкам/​аудио файлам) ​**регистрозависимы** — то есть, если файл называется "''​%%image.jpg%%''",​ а в файле игры записано "''​%%Image.jpg%%''"​ или "''​%%image.JPG%%''",​ то плеер не сможет показать такую картинку;​ 
- * Для проигрывания аудио используются встроенные средства браузера,​ поэтому рекомендованный формат для плеера — ''​.mp3''​ как самый поддерживаемый (хорошая альтернатива — ''​.webm'',​ у него меньше размер при том же качестве,​ но чуть хуже с поддержкой браузеров);​ +  * Для проигрывания аудио используются встроенные средства браузера,​ поэтому рекомендованный формат для плеера — ''​%%.mp3%%''​ как самый поддерживаемый (хорошая альтернатива — ''​%%.webm%%'',​ у него меньше размер при том же качестве,​ но чуть хуже с поддержкой браузеров);​ 
- * Есть возможность пропуска wait (кликом по странице);​ +  * Есть возможность пропуска ​''​%%wait%%'' ​(кликом по странице);​ 
- * Сохранения хранятся в браузере;​ +  * **Сохранения хранятся в браузере**
- * Можно открывать игры, упакованные в zip-архив или в aqsp-архив;​ +  * Можно открывать игры, упакованные в rar-архив, ​zip-архив или в aqsp-архив;​ 
- * Можно открывать игры в виде текстового файла формата **TXT2GAM** (**QSPS**) (см. ниже раздел "​Запуск игр в формате текстовых файлов"​).+  * Можно открывать коллекции игр, упакованных в один архив (в корне архива должен находиться файл ''​%%game.cfg%%''​ с описанием всех игр). 
 +  ​* Можно открывать игры в виде текстового файла формата **TXT2GAM** (**QSPS**) (см. ниже раздел "​Запуск игр в формате текстовых файлов"​). 
 +  * Можно создавать собственные темы оформления и переключаться между ними из кода QSP. 
 +  * Расширенные возможности взаимодействия с интерфейсом и HTML-разметкой. 
 +  * Возможность связать вызов кода QSP с событиями браузера (клик, двойной клик и т.п.).
  
-Обратите внимание:​ чтобы запустить игру из архива,​ QSP-файл игры должен находится в корне архива (не в подпапке),​ а так же в корне должен быть только один QSP-файл (если используются дополнительные QSP-файлы,​ то они должны быть расположены в подпапках).+**Обратите внимание**: чтобы запустить игру из архива,​ QSP-файл игры должен находится в корне архива (не в подпапке),​ а так же в корне должен быть только один QSP-файл (если используются дополнительные QSP-файлы,​ то они должны быть расположены в подпапках).
  
 ===== Десктопная версия ===== ===== Десктопная версия =====
Строка 44: Строка 50:
 ==== Основные отличия desktop-версии от web-версии:​ ==== ==== Основные отличия desktop-версии от web-версии:​ ====
  
- * возможность открыть QSP-файл или qsps-файл из папки (в отличии от web-версии,​ где можно открыть только архив);​ +  ​* открытие игры через drag-n-drop — перетаскивание файла игры на окно плеера;​ 
- * открытие игры через drag-n-drop — перетаскивание файла игры на окно плеера;​ +  * открытие игры через консоль;​ 
- * открытие игры через консоль;​ +  ''​%%game.cfg%%''​ подключается, даже если игра ​не упакована в архив
-загрузка файла конфига из папки с игрой+  * дополнительная секция в файле конфига для настройки окна desktop-плеера;​ 
- * дополнительная секция в файле конфига для настройки окна desktop-плеера;​ +  * автоматическое обновление desktop-плеера при выходе новой версии.
- * из плеера нельзя удалить демонстрационные игры; +
- * автоматическое обновление desktop-плеера при выходе новой версии.+
  
 ==== Установка и запуск ==== ==== Установка и запуск ====
Строка 76: Строка 80:
 ==== Основные отличия web-версии от desktop-версии:​ ==== ==== Основные отличия web-версии от desktop-версии:​ ====
  
- не поддерживается (или поддерживается не полностью) ​запуск QSP-файлов и текстовых qsps-файлов;​ +  ​* запуск QSP-файлов и текстовых qsps-файлов ​с компьютера возможен,​ но к игре не подключаются ресурсы и файлы конфигурации
- * игры могут иметь общий файл конфигурации,​ который загружается из папки "''​game''";​ приоритет у индивидуальных файлов конфигураций;​ +  * игры могут иметь общий файл конфигурации,​ который загружается из папки "''​%%game%%''";​ приоритет у индивидуальных файлов конфигураций;​ 
- * можно открыть файл со списком игр или отдельную игру по ссылке (см. раздел "​Запуск игр по ссылке"​).+  * можно открыть файл со списком игр или отдельную игру по ссылке (см. раздел "​Запуск игр по ссылке"​).
  
 ==== Установка и запуск плеера на компьютере ==== ==== Установка и запуск плеера на компьютере ====
 +
 +**Стандалон-сборка**
  
 Прежде всего вам необходимо скачать архив "''​qspider-player-standalone.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]]. Содержимое архива распакуйте в любую папку, эта папка и будет местом расположения плеера. Прежде всего вам необходимо скачать архив "''​qspider-player-standalone.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]]. Содержимое архива распакуйте в любую папку, эта папка и будет местом расположения плеера.
  
-Из-за ограничений безопасности плеер нельзя запустить просто открыв файл "''​index.html''"​ в браузере.+Из-за ограничений безопасности плеер нельзя запустить просто открыв файл "''​%%index.html%%''"​ в браузере.
  
-Поэтому для запуска необходим локально запущенный сервер — можно использовать один из [[https://​gist.github.com/​willurd/​5720255|списка]] или же расширение хрома [[https://​chrome.google.com/​webstore/​detail/​web-server-for-chrome/​ofhbbkphhbklhfoeikjpcbhemlocgigb|"​Web Server for Chrome"​]].+Поэтому для запуска необходим локально запущенный сервер — можно использовать один из [[https://​gist.github.com/​willurd/​5720255|списка]].
  
-Дальнейшие инструкции ориентированы на использование расширения:+Более простой способ запустить веб-версию — использовать VS Code с расширением Live Server: * Скачайте и установите бесплатный [[https://​code.visualstudio.com|VS Code]]. 
 +  * Запустите его по окончании установки. 
 +  * Установите на него расширение [[https://​github.com/​ritwickdey/​vscode-live-server-plus-plus|Live Server]]. Для этого:​ 
 +    * Откройте меню и выберите пункты ''​%%File → Preferences → Extensions%%'',​ или ​нажмите сочетание клавиш ''​%%Ctrl + Shift + X%%''​ 
 +    * Слева появится поисковая строка для расширений, введите в неё текст: "''​%%Live Server%%''"​. 
 +    * В списке найденных ​расширений будет расширение "Live Server",​ установите его, нажав кнопку ''​%%Install%%''​. 
 +    * Когда расширение установится, в правом нижнем углу VS Code появится кнопка "''​%%Go Live%%''"​ 
 +  * В VS Code откройте папку с распакованной браузерной версией плеера. Меню "''​%%File → Open Folder...%%''"​ 
 +  * Выберите из списка файлов в папке файл ''​%%index.html%%''​. 
 +  * Нажмите кнопку ''​%%Go Live%%''​.
  
- * устанавливаем "Web Server for Chrome"​ +Если вы всё сделали ​правильнов браузере откроется **qSpider**.
-в адресной ​строке в хроме пишем "''​chrome:​%%//​%%apps/''"​ и выбираем в списке "Web Server";​ +
- * в открывшемся попапе выбираем папку, в которую распаковали плеер и запускаем сервер; +
- * там же в попапе будет ссылка на запуск сервера в окне браузера.+
  
-==== Установка ​плеера на github ====+Поскольку ни одна игра в **qSpider** ​не добавлена, в окне браузера будет проигрываться бесконечная ​анимация.
  
- - Ознакомьтесь с порядком установки плеера на компьютер. Лучше выделить отдельную папку и распаковать ​браузерную версию плеера туда. Затем открыть подпапку "''​game''"​ и удалить из неё ненужные файлы игр, и добавить свои, которые хотите разместить на гитхабе (см. ​раздел "​добавление и удаление игр из списка"​ ниже). +Для тогочтобы игра ​проигрывалась в браузерной версии плеера,​ нужно добавить игру и файл ''​%%game.cfg%%'' ​в папку ''​%%game%%''​, расположенную в папке с плеером.
- - Отредактируйте файл "''​game.cfg''"​ так, чтобы в нём присутствовали все секции на каждую из размещаемых игр (см. статью [[help:​qspider_gamecfg|"​Конфигурационный файл"​]]). +
- - Откройте [[https://​github.com|github]] ​в браузере, зайдите в свой профиль и создайте новый публичный репозиторий с любым ​именем, для ​примера:​ "''​qspider-game''"​. +
- - В разделе "​Code"​ нажмите кнопку "​Main"​. +
- - В открывшемся окошке в поле "Find or create branch..."​ введите название новой ветки "​gh-pages"​а затем ​нажмите на кнопку "​Create branch: gh-pages from main"​. +
- - Обязательно переключитесь на ветку "​gh-pages",​ если это не произошло автоматически. Вместо кнопки "​main"​ у вас ​должна появиться кнопка "​gh-pages"​. +
- - В этом же разделе найдите и нажмите кнопку "Add file" и выберите пункт "​Upload files",​ откроется страница загрузки файлов на github. +
- - Перетащите все распакованные файлы браузерной версии плеера в соответствующее поле на странице (в т.ч. папки "''​assets''"​ и "''​game''​"). +
- - Теперь ​по адресу "''​%%https://​username.github.io/​qspider-game%%''​" станет доступна страничка с вашими играми. (Соответственно вместо "​username"​ будет ​ваш ник на гитхабе,​ а вместо "​qspider-game"​ — название репозитория, который вы только что создали).+
  
-Есть видео на тему: [[https://​www.youtube.com/​watch?​v=bEjRzTDsPp4&​t=3029s|Размещение игры онлайн с использованием GitHub]], однако там создание страницы производится другим способом,​ без создания ветки "​gh-pages"​.+**Плеер с полкой игр**
  
-==== Добавление и удаление ​игр из списка ​====+Порядок установки веб-версии плеера с полкой ​игр мало чем отличается от установки стандалон варианта для веб-версии. Единственное отличие заключается в том, что вам нужно ​скачать архив "''​qspider-player.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]].
  
-По умолчанию ​вместе с плеером упакованы демонстрационные игры. Вы можете заменить их, или просто добавить свою игру к списку.+Далее всё делаем точно так же, как в выше изложенной ​инструкции.
  
-Демонстрационные игры лежат в подпапке "''​game''", ​там ​же лежит конфигурационный файл "''​game.cfg''"​+После запуска сервера в браузере откроется **qSpider** с полкой игр. Эта версия **qSpider** ничем не будет отличаться от версии, доступной по ссылке **[[https://​qspfoundation.github.io/​qspider/​|qspfoundation.github.io/​qspider]]**.
  
-Для добавления своей игры ​в список, нужно разместить игру в папке "''​game''"​ одним из следующих способов:​+==== Установка ​плеера на github ====
  
-скопировать ​zip-архив с упакованной в него игрой в папку "''​game''"​ +  - Ознакомьтесь с порядком установки ​плеера на компьютер. Лучше выделить отдельную папку ​и распаковать ​браузерную ​версию плеера туда. Затем открыть подпапку "''​%%game%%''"​ и добавить ​в неё свою игру, которую хотите разместить на гитхабе. 
- * скопировать папку с игрой в папку "''​game''"​ +  - Отредактируйте файл ​"''​%%game.cfg%%''" ​так, чтобы в нём ​присутствовали все необходимые секции настроек (см. статью [[help:​qspider_gamecfg|"​Конфигурационный файл"​]]). 
- если ваша игра имеет ​формат игры ​для ​AeroQSP, ​скопировать файл "''​.aqsp''"​ вашей игры в папку "''​game''​"+  - Откройте [[https://​github.com|github]] ​в браузере,​ зайдите в свой ​профиль и создайте новый ​публичный репозиторий с любым именем,​ для примера: ​"''​qspider-game''"​. 
 +  - В разделе "​Code"​ нажмите кнопку "​Main"​. 
 +  - В открывшемся окошке в поле "Find or create branch..."​ введите название новой ветки "​gh-pages", ​а затем нажмите на кнопку "​Create branch: gh-pages from main"​. 
 +  - Обязательно переключитесь на ветку "​gh-pages",​ если это не произошло автоматически. Вместо кнопки "​main"​ у вас ​должна появиться кнопка "​gh-pages"​. 
 +  - В этом же разделе найдите и нажмите кнопку "Add file" и выберите пункт "​Upload files",​ откроется страница загрузки файлов на github. 
 +  - Перетащите все распакованные ​файлы браузерной версии плеера в соответствующее поле на странице. В т.ч. пять папок: ​"''​%%aero%%''",​ "''​%%assets%%''",​ "''​%%game%%''",​ "''​%%locales%%''",​ "''​%%themes%%''"​. 
 +  - Теперь по адресу "''​%%https://​username.github.io/​qspider-game%%''" ​станет доступна страничка с вашей игрой. (Соответственно вместо "​username"​ будет ​ваш ник на гитхабе,​ а вместо ​"qspider-game" ​— название репозитория,​ который вы только что создали).
  
-Чтобы ​игра ​отобразилась в списке, необходимо ​отредактировать файл "''​game.cfg''"​. Конфигурация каждой игры ​в файле начинается ​с заголовка ​секции "''​**%%[[game]]%%**''", ​далее перечисляется несколько параметров:​+Есть видео на тему: [[https://​www.youtube.com/​watch?​v=bEjRzTDsPp4&​t=3029s|Размещение игры онлайн с использованием GitHub]], ​однако там создание страницы производится ​другим способом, без ​создания ветки "​gh-pages"​.
  
- * **id** — уникальный идентификатор игры (используется для сохранений);​ +==== Запуск игр по ссылке ====
- * **title** — название игры (будет показано в заголовке плеера);​ +
- * **description** — необязательное краткое описание ​игры, аннотация;​ +
- * **file** — путь к файлу с игрой относительно файла "''​game.cfg''",​ или внешняя ​ссылка (например ''​file ​"​%%https://​qspfoundation.github.io/​qspider/​game/​skazka/​skazka.qsp%%"'';​ +
- * **mode** — если ваша игра написана для AeroQSP, данному параметру назначается значение "''​aero''"​.+
  
-Таким ​образом вам нужно ​добавить в файл "''​game.cfg''"​ новую секцию для вашей ​игры примерно такого ​содержания:+**ВНИМАНИЕ!!!** Возможность запуска игр по ссылке ограничена — на сервере, ​на котором лежит игра, должна быть включена поддержка CORS.
  
-<​sxh>​ +**Важно!** Запускать сторонние игры ​может только версия плеера со встроенным каталогом ​игр.
-[[game]] +
-id="уникальный-идентификатор-может-быть-и-просто-числом" +
-title="​Название игрыотображаемое в виде заголовка на странице+
-description="""​Краткое описание игры, которое будет отображаться на странице со списком игр. Аннотация."""​ +
-file="​путь к файлу игры/mygame.qsp" +
-</​sxh>​+
  
-Если вы убрали демонстрационные игры из папки "''​game''",​ не забудьте удалить соответствующие ​секции из файла "''​game.cfg''"​.+В чём ​смысл.
  
-См. так же информацию в статье [[help:​qspider_gamecfg|"​Конфигурационный файл"]].+Нам не нужно, чтобы все игры, которые мы хотим запускать ​с нашего сайта, лежали прямо у нас на сайте. Мы можем запускать игры, которые ​лежат на других сайтах.
  
-Обратите внимание! Если вы указываете путь к внешнему файлу ​игры, нужно помнить о ряде ограничений, накладываемых браузером:+Например, **qSpider** у нас установлен по адресу "''​%%https://​qspfoundation.github.io/​qspider%%''", ​а игра лежит ​по адресу "''​%%https://​aleksversus.github.io/​merphy_law/​game/​merphy_law.qsp%%''"​.
  
- * с https страницы нельзя загрузить http ссылку; +Мы можем ввести в адресную строку, ​или вставить в атрибут ''​%%href%%''​ гиперссылки следующий ​адреси он откроет нашу игру в указанном "​плеере"​ **qSpider**:​
- * у сервера, где находится иградолжны быть настроены [[https://​developer.mozilla.org/​ru/​docs/​Web/​HTTP/​CORS|CORS заголовки]].+
  
-==== Запуск игр по ссылке ====+<​sxh>​ 
 +https://​qspfoundation.github.io/​qspider/?​game=https://​aleksversus.github.io/​merphy_law/​game/​merphy_law.qsp 
 +</​sxh>​
  
-**ВНИМАНИЕ!!!** Возможность запуска ​игр ​по ссылке ограничена ​— на сервере,​ на котором ​лежит ​игра, должна быть включена поддержка CORS.+При этом игра будет загружена на полку игр.
  
-В чём смысл.+Открыть таким же образом игру в онлайн-плеере,​ в котором нет полки игр (то есть в плеере для стандалон-сборки),​ не получится.
  
-Нам не нужно, чтобы все ​игры, которые мы хотим запускать с нашего сайта ​лежали прямо у нас на сайте. Мы можем запускать ​игры, которые лежат на других ​сайтах.+Таким же образом можно загружать игры ​целым пакетом, сославшись на один конфигурационный файл (конфиг)в котором описаны сразу несколько игр:
  
-Например,​ **qSpider** у нас установлен по адресу "''​**%%https://​qspfoundation.github.io/​qspider%%**''",​ а игра лежит по адресу "''​%%https://​aleksversus.narod.ru/arch/verenitsa_mirov.zip%%''"​.+<​sxh>​ 
 +https://​qspfoundation.github.io/​qspider/?config=https://​aleksversus.github.io/QSP-storage/game/game.cfg 
 +</​sxh>​
  
-Мы можем ввести в адресную строку, ​или вставить ​в атрибут ''​**href**'' ​гиперссылки следующий адрес, и он откроет нашу игру ​в указанном плеере **qSpider**:​+После загрузки ​всех игр на полку, самая первая игра в конфиге будет ​запущена ​автоматически.
  
-<sxh html> +А ещё можно упаковать несколько игр в zip-архив,​ поместить в корень архива конфигурационный файл, и сделать ссылку на архив — все игры из архива тоже будут загружены на полку.
-https://​qspfoundation.github.io/​qspider/?​game=https://​aleksversus.narod.ru/​arch/​verenitsa_mirov.zip +
-</​sxh>​+
  
-Таким же образом можно ​загружать конфигурационные файлы:+==== Запуск игр из каталога ​по ссылке ====
  
-<sxh html> +Игру, опубликованную в каталоге игр qsp.org, можно запускать по прямой ссылке. Она автоматически добавится на полку и запустится. Чтобы получить такую ссылку:​ 
-https://qspfoundation.github.io/qspider/?config=https://​qspfoundation.github.io/​qspider/​game/​game.cfg + 
-</​sxh>​+  * откройте страницу с игрой на сайте qsp.org 
 +  * скопируйте адрес из адресной строки. Должно получиться что-то вроде этого: ​<sxh html>​https://​qsp.org/index.php?option=com_sobi2&​sobi2Task=sobi2Details&​catid=6&​sobi2Id=84&​Itemid=55</​sxh>​ 
 +  * Найдите в этом адресе часть, начинающуюся с **sobi2Id**. Число после знака равенства является идентификатором игры в каталоге. Например,​ для ссылки выше это число 84. 
 +  * Теперь возьмите полную ссылку к онлайн-версии плеера,​ и укажите через вопросительный знак параметр **catalogId** и идентификатор игры в каталоге. Получится вот такая ссылка:​ <sxh html>https://​qspfoundation.github.io/​qspider/​?​catalogId=84</​sxh>​
  
 ===== Запуск игр в формате текстовых файлов ===== ===== Запуск игр в формате текстовых файлов =====
  
-Для того, чтобы ​иметь возможность ​писать игры QSP в текстовом редакторе,​ был разработан специальный формат текстовых файлов под названием **TXT2GAM**. Ещё его можно называть "​формат **QSPS**"​ по названию общепринятого расширения "''​.qsps''",​ которое таким файлам назначается. Подробное описание формата вы найдёте в статье [[help:​txt2gam|"​TXT2GAM. Краткое руководство"​]].+Для того, чтобы писать игры QSP в текстовом редакторе,​ был разработан специальный формат ​для ​текстовых файлов под названием **TXT2GAM**. Ещё его можно называть "​формат **QSPS**"​ по названию общепринятого расширения "''​%%.qsps%%''",​ которое таким файлам назначается. Подробное описание формата вы найдёте в статье [[help:​txt2gam|"​TXT2GAM. Краткое руководство"​]].
  
 Обычно игры, написанные в этом формате,​ требуется сконвертировать в файл игр QSP с помощью специальной утилиты **TXT2GAM**. Однако **qSpider** позволяет запускать такие игры прямо из qsps-файлов,​ не конвертируя их. Обычно игры, написанные в этом формате,​ требуется сконвертировать в файл игр QSP с помощью специальной утилиты **TXT2GAM**. Однако **qSpider** позволяет запускать такие игры прямо из qsps-файлов,​ не конвертируя их.
Строка 178: Строка 182:
 Требования к играм, написанным в виде текстовых файлов:​ Требования к играм, написанным в виде текстовых файлов:​
  
- * Игра обязательно должна быть написана в формате **[[help:​txt2gam|TXT2GAM (QSPS)]]**;​ +  ​* Игра обязательно должна быть написана в формате **[[help:​txt2gam|TXT2GAM (QSPS)]]**;​ 
- * Файл должен иметь расширение "''​.qsps''";​ +  * Файл должен иметь расширение "''​%%.qsps%%''";​ 
- * Файл должен быть сохранён в кодировке **utf-8** (рекомендуется),​ или **utf-16le**.+  * Файл должен быть сохранён в кодировке **utf-8** (рекомендуется),​ или **utf-16le**.
  
 **Quest Generator** позволяет экспортировать игру в qsps-файл именно в кодировке **utf-16le**,​ однако предпочтительнее использовать кодировку **utf-8**, поскольку в этом случае файл будет гораздо меньше по объёму. **Quest Generator** позволяет экспортировать игру в qsps-файл именно в кодировке **utf-16le**,​ однако предпочтительнее использовать кодировку **utf-8**, поскольку в этом случае файл будет гораздо меньше по объёму.
Строка 186: Строка 190:
 ===== Стандартные горячие клавиши ===== ===== Стандартные горячие клавиши =====
  
- * ''​ctrl+s''​ - меню сохранения +  ​* ''​%%ctrl+r%%''​ - перезапуск игры (Заново) 
- * ''​ctrl+o''​ - меню загрузки +  * ''​%%ctrl+s%%''​ - меню сохранения 
- * ''​f5''​ - quicksave (быстрое сохранение) +  * ''​%%ctrl+o%%''​ - меню загрузки 
- * ''​f9''​ - quickload (быстрая загрузка)+  * ''​%%f5%%''​ - quicksave (быстрое сохранение) 
 +  * ''​%%f9%%''​ - quickload (быстрая загрузка) 
 +  * ''​%%PageUp%%''​ - увеличить громкость 
 +  * ''​%%PageDown%%''​ - уменьшить громкость 
 +  * ''​%%Home%%''​ - выключить звук 
 +  * ''​%%End%%''​ - включить звук 
 +  * ''​%%Space%%''​ - единственное действие 
 +  * ''​%%1 ... 9%%''​ - действия с 1 по 9 по порядку.
  
 ===== Список полезных ссылок о qSpider ===== ===== Список полезных ссылок о qSpider =====
Строка 195: Строка 206:
 ==== в QSP-WIKI: ==== ==== в QSP-WIKI: ====
  
- * [[help:​qspider_gamecfg|Конфигурационный файл]] +  ​* [[help:​qspider_gamecfg|Конфигурационный файл]] 
- * [[help:​qspider_aeroqsp|Особенности запуска и работы игр AeroQSP на qSpider]]+  * [[help:​qspider_aeroqsp|Особенности запуска и работы игр AeroQSP ​на qSpider]] 
 +  * [[help:​qspider_interface|Взаимодействие с интерфейсом]] 
 +  * [[help:​qspider_themes|Темы оформления]] 
 +  * [[help:​qspider_spectags|Специальные теги]] 
 +  * [[help:​qspider_inclib|Встроенная библиотека]] 
 +  * [[help:​qspider_standalone|Стандалон-сборка игры ​на qSpider]]
  
 ==== на IFHUB (краткая история версий) ==== ==== на IFHUB (краткая история версий) ====
  
- * [[https://​ifhub.club/​2020/​10/​11/​qspider-pleer-dlya-zapuska-qsp-igr-v-brauzere.html|qSpider - плеер для запуска QSP игр в браузере]] +  ​* [[https://​ifhub.club/​2020/​10/​11/​qspider-pleer-dlya-zapuska-qsp-igr-v-brauzere.html|qSpider - плеер для запуска QSP игр в браузере]] 
- * [[https://​ifhub.club/​2020/​10/​11/​qspider-hotkeys.html|qSpider HotKeys - горячие клавиши]] +  * [[https://​ifhub.club/​2020/​10/​11/​qspider-hotkeys.html|qSpider HotKeys - горячие клавиши]] 
- * [[https://​ifhub.club/​2020/​10/​18/​qspider-090.html|qSpider 0.9.0 - список игр в конфиге]] +  * [[https://​ifhub.club/​2020/​10/​18/​qspider-090.html|qSpider 0.9.0 - список игр в конфиге]] 
- * [[https://​ifhub.club/​2020/​11/​01/​qspider-091.html|qSpider 0.9.1 - загрузка игр из zip]] +  * [[https://​ifhub.club/​2020/​11/​01/​qspider-091.html|qSpider 0.9.1 - загрузка игр из zip]] 
- * [[https://​ifhub.club/​2021/​05/​23/​qspider-0100.html|qSpider 0.10.0 - подключение дополнительных ресурсов]] +  * [[https://​ifhub.club/​2021/​05/​23/​qspider-0100.html|qSpider 0.10.0 - подключение дополнительных ресурсов]] 
- * [[https://​ifhub.club/​2021/​10/​22/​qspider-0110.html|qSpider 0.11.0 - поддержка игр в AeroQSP-формате]] +  * [[https://​ifhub.club/​2021/​10/​22/​qspider-0110.html|qSpider 0.11.0 - поддержка игр в AeroQSP-формате]] 
- * [[https://​ifhub.club/​2022/​02/​06/​qspider-0120.html|qSpider 0.12.0 - полноценная desktop-версия]] +  * [[https://​ifhub.club/​2022/​02/​06/​qspider-0120.html|qSpider 0.12.0 - полноценная desktop-версия]] 
- * [[https://​ifhub.club/​2022/​10/​05/​qspider-0130.html|qSpider 0.13.0]]+  * [[https://​ifhub.club/​2022/​10/​05/​qspider-0130.html|qSpider 0.13.0]] 
 +  * [[https://​ifhub.club/​2024/​01/​03/​qspider-100.html|qSpider 1.0.0 — Полка игр и Каталог]] 
 +  * [[https://​ifhub.club/​2024/​01/​10/​qspider-101.html|qSpider 1.0.1]] 
 +  * [[https://​ifhub.club/​2024/​02/​11/​qspider-110.html|qSpider 1.1.0 — Стандалон]] 
 +  * [[https://​ifhub.club/​2024/​07/​15/​qspider-120.html|qSpider 1.2.0 — китайский язык]] 
 +  * [[https://​ifhub.club/​2024/​09/​29/​qspider-130.html|qSpider 1.3.0 — переход на библиотеку QSP 5.9.0]]
  
 ==== Другие ссылки ==== ==== Другие ссылки ====
  
- * [[https://​qsp.org/​index.php?​option=com_agora&​task=topic&​id=1291&​Itemid=57|Обсуждение плеера на форуме QSP.org]] +  ​* [[https://​qsp.org/​index.php?​option=com_agora&​task=topic&​id=1291&​Itemid=57|Обсуждение плеера на форуме QSP.org]] 
- * [[https://​vk.com/​@qsplayer-qspider-v-0120-svodnaya-statya|Сводная статья по версии 0.12.0 в вк]] +  * [[https://​vk.com/​@qsplayer-qspider-v-0120-svodnaya-statya|Сводная статья по версии 0.12.0 в вк]]
  
 [[help:​qgen|Вперёд:​ Quest Generator]] [[help:​qgen|Вперёд:​ Quest Generator]]
 +
help/qspider.1710235027.txt.gz · Последние изменения: 2024/03/12 09:17 — aleks_versus