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

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


help:qspider

Различия

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

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

Both sides previous revision Предыдущая версия
Следущая версия
Предыдущая версия
help:qspider [2023/04/19 17:02]
aleks_versus [Установка плеера на github]
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]]. ​Одна из представленных игр была написана для **AeroQSP**.+Демонстрацию работы плеера можно посмотреть здесь: 
 + 
 +  * Поиграть в 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-файлы,​ то они должны быть расположены в подпапках).
  
 ===== Десктопная версия ===== ===== Десктопная версия =====
Строка 43: Строка 50:
 ==== Основные отличия desktop-версии от web-версии:​ ==== ==== Основные отличия desktop-версии от web-версии:​ ====
  
- * возможность открыть QSP-файл или qsps-файл из папки (в отличии от web-версии,​ где можно открыть только архив);​ +  ​* открытие игры через drag-n-drop — перетаскивание файла игры на окно плеера;​ 
- * открытие игры через drag-n-drop — перетаскивание файла игры на окно плеера;​ +  * открытие игры через консоль;​ 
- * открытие игры через консоль;​ +  ''​%%game.cfg%%''​ подключается, даже если игра ​не упакована в архив
-загрузка файла конфига из папки с игрой+  * дополнительная секция в файле конфига для настройки окна desktop-плеера;​ 
- * дополнительная секция в файле конфига для настройки окна desktop-плеера;​ +  * автоматическое обновление desktop-плеера при выходе новой версии.
- * из плеера нельзя удалить демонстрационные игры; +
- * автоматическое обновление desktop-плеера при выходе новой версии.+
  
 ==== Установка и запуск ==== ==== Установка и запуск ====
Строка 75: Строка 80:
 ==== Основные отличия web-версии от desktop-версии:​ ==== ==== Основные отличия web-версии от desktop-версии:​ ====
  
- не поддерживается (или поддерживается не полностью) ​запуск QSP-файлов и текстовых qsps-файлов;​ +  ​* запуск QSP-файлов и текстовых qsps-файлов ​с компьютера возможен,​ но к игре не подключаются ресурсы и файлы конфигурации
- * игры могут иметь общий файл конфигурации,​ который загружается из папки "''​game''";​ приоритет у индивидуальных файлов конфигураций;​ +  * игры могут иметь общий файл конфигурации,​ который загружается из папки "''​%%game%%''";​ приоритет у индивидуальных файлов конфигураций;​ 
- * из плеера можно удалить демонстрационные игры; +  * можно открыть файл со списком игр или отдельную игру по ссылке (см. раздел "​Запуск игр по ссылке"​).
- * можно открыть файл со списком игр или отдельную игру по ссылке (см. раздел "​Запуск игр по ссылке"​).+
  
 ==== Установка и запуск плеера на компьютере ==== ==== Установка и запуск плеера на компьютере ====
  
-Прежде всего вам необходимо скачать архив "''​qspider-player.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]]. Содержимое архива распакуйте в любую папку, эта папка и будет местом расположения плеера.+**Стандалон-сборка**
  
-Из-за ограничений безопасности ​плеер ​нельзя запустить просто ​открыв файл "''​index.html''"​ в браузере.+Прежде всего вам необходимо скачать архив "''​qspider-player-standalone.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]]. Содержимое архива распакуйте в любую папку, эта папка ​и будет местом расположения плеера.
  
-Поэтому для ​запуска необходим локально запущенный сервер — можно использовать один из [[https://​gist.github.com/​willurd/​5720255|списка]] или же расширение хрома [[https://​chrome.google.com/​webstore/​detail/​web-server-for-chrome/​ofhbbkphhbklhfoeikjpcbhemlocgigb|"​Web Server for Chrome"​]].+Из-за ограничений ​безопасности ​плеер ​нельзя запустить просто открыв файл "''​%%index.html%%''"​ в браузере.
  
-Дальнейшие инструкции ориентированы на использование расширения:+Поэтому для запуска необходим локально запущенный ​сервер — можно использовать один из [[https://​gist.github.com/​willurd/​5720255|списка]].
  
- * устанавливаем ​"​Web ​Server ​for Chrome"​ +Более простой способ запустить ​веб-версию — использовать VS Code с расширением Live ServerСкачайте и установите бесплатный [[https://​code.visualstudio.com|VS Code]]. 
- в адресной строке в хроме ​пишем "''​chrome:%%//%%apps/''​" ​и выбираем в списке "Web Server"​; +  * Запустите его по окончании установки. 
-в открывшемся попапе выбираем ​папкув которую распаковали плеер и запускаем сервер+  * Установите на него ​расширение [[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%%''​.
  
-==== Установка плеера на github ====+Если вы всё сделали правильнов браузере откроется **qSpider**.
  
- - Ознакомьтесь с порядком установки плеера на компьютер. Лучше выделить отдельную папку и распаковать браузерную версию плеера туда. Затем открыть подпапку "''​game''"​ и удалить из неё ненужные файлы ​игр, и добавить свои, которые хотите разместить ​на гитхабе (см. раздел "добавление и удаление игр из списка"​ ниже). +Поскольку ни одна игра в **qSpider** ​не добавлена,​ в окне браузера ​будет проигрываться бесконечная анимация.
- - Отредактируйте файл "''​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"​.+Для ​того, чтобы игра проигрывалась в браузерной версии плеера, нужно добавить игру и файл ''​%%game.cfg%%''​ в папку ''​%%game%%'',​ расположенную ​в папке с плеером.
  
-==== Добавление и удаление ​игр ​из списка ====+**Плеер с полкой ​игр**
  
-По умолчанию вместе с плеером упакованы демонстрационные игрыВы можете заменить ихили просто добавить свою игру к списку.+Порядок установки веб-версии плеера с полкой игр ​мало чем отличается от установки стандалон варианта для веб-версииЕдинственное отличие заключается в том, что вам ​нужно скачать архив "''​qspider-player.zip''"​ с web-версией плеера со [[https://​github.com/​qspfoundation/​qspider/​releases|страницы релизов]].
  
-Демонстрационные игры ​лежат в подпапке "''​game''"​там же лежит конфигурационный файл "''​game.cfg''"​+Далее всё делаем точно так же, как в выше изложенной ​инструкции.
  
-Для добавления ​своей игры в список,​ нужно ​разместить игру в папке "''​game''"​ одним ​из следующих способов:+После запуска сервера в браузере откроется **qSpider** с полкой ​игр. Эта версия **qSpider** ​ничем не будет отличаться от версии, доступной по ссылке **[[https://​qspfoundation.github.io/​qspider/​|qspfoundation.github.io/​qspider]]**.
  
-скопировать zip-архив с упакованной в него игрой в папку "''​game''"​ +==== Установка плеера ​на github ====
- * скопировать папку с игрой в папку "''​game''"​ +
- * если ваша игра имеет формат игры для AeroQSP, скопировать файл "''​.aqsp''"​ вашей игры в папку "''​game''"​+
  
-Чтобы игра отобразилась в списке, необходимо отредактировать файл "''​game.cfg''"​. Конфигурация каждой игры в файле начинается с заголовка секции "''​**%%[[game]]%%**''", ​далее перечисляется несколько параметров:+  - Ознакомьтесь с порядком установки плеера на компьютер. Лучше выделить ​отдельную папку и распаковать ​браузерную версию плеера туда. Затем открыть подпапку "''​%%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. 
 +  - Перетащите все распакованные файлы браузерной версии плеера в соответствующее поле на странице. В т.ч. пять папок: "''​%%aero%%''",​ "''​%%assets%%''", ​"''​%%game%%''", ​"''​%%locales%%''",​ "''​%%themes%%''"​. 
 +  - Теперь по адресу "''​%%https://​username.github.io/​qspider-game%%''"​ станет доступна страничка ​с вашей игрой. (Соответственно вместо "​username"​ будет ваш ник на гитхабе, а вместо "​qspider-game"​ — название ​репозитория,​ который ​вы только что создали).
  
- * **id** — уникальный ​идентификатор игры (используется для сохранений); +Есть видео на тему: [[https://​www.youtube.com/​watch?​v=bEjRzTDsPp4&​t=3029s|Размещение игры онлайн с использованием GitHub]], ​однако ​там ​создание ​страницы производится ​другим способом, без создания ветки ​"gh-pages".
- * **title** — название игры ​(будет показано ​в заголовке плеера); +
- * **description** — необязательное краткое описание ​игры, аннотация; +
- * **file** — путь к файлу с игрой относительно файла "''​game.cfg''",​ или внешняя ссылка (например ''​file = "​%%https://​qspfoundation.github.io/​qspider/​game/​skazka/​skazka.qsp%%"'';​ +
- * **mode** — если ваша игра написана для AeroQSP, данному параметру назначается значение "''​aero''​".+
  
-Таким образом вам нужно добавить в файл "''​game.cfg''"​ новую ​секцию для вашей ​игры примерно такого содержания:​+==== Запуск игр по ссылке ====
  
-<​sxh>​ +**ВНИМАНИЕ!!!** Возможность запуска ​игр по ссылке ограничена — на сервере, на котором лежит игра, должна быть включена поддержка CORS.
-[[game]] +
-id="​уникальный-идентификатор-может-быть-и-просто-числом" +
-title="​Название игры, отображаемое в виде заголовка на странице+
-description="""​Краткое описание игры, ​которое ​будет отображаться на странице со списком игр. Аннотация."""​ +
-file="​путь ​к файлу игры/​mygame.qsp" +
-</​sxh>​+
  
-Если вы убрали демонстрационные игры ​из папки "''​game''",​ не забудьте удалить соответствующие секции из файла "''​game.cfg''"​.+**Важно!** Запускать сторонние игры ​может только версия плеера ​со встроенным ​каталогом игр.
  
-См. так же информацию в статье [[help:​qspider_gamecfg|"​Конфигурационный файл"]].+В чём смысл.
  
-Обратите внимание! Если вы указываете путь ​к внешнему ​файлу игры, ​нужно помнить о ряде ограничений, ​накладываемых браузером:​+Нам не нужно, чтобы все игрыкоторые мы хотим запускать с нашего сайта, лежали прямо у нас на сайте. Мы можем запускать ​игры, ​которые лежат на других сайтах.
  
- * с https страницы нельзя загрузить http ссылку;​ +Например, **qSpider** ​у нас установлен по адресу "''​%%https://​qspfoundation.github.io/​qspider%%''", ​а игра лежит по адресу "''​%%https://aleksversus.github.io/merphy_law/game/merphy_law.qsp%%''"​.
-у сервера, где находится ​игра, должны быть настроены [[https://developer.mozilla.org/ru/docs/Web/​HTTP/​CORS|CORS заголовки]].+
  
-==== Запуск игр по ссылке ​====+Мы можем ввести в адресную строку, или вставить в атрибут ''​%%href%%''​ гиперссылки следующий адрес, и он откроет нашу игру в указанном "​плеере" **qSpider**:​
  
-**ВНИМАНИЕ!!!** Возможность запуска игр по ссылке ограничена — на сервере,​ на котором лежит игра, должна быть включена поддержка CORS.+<​sxh>​ 
 +https://​qspfoundation.github.io/​qspider/?​game=https://​aleksversus.github.io/​merphy_law/​game/​merphy_law.qsp 
 +</​sxh>​
  
-В чём смысл.+При этом игра будет загружена на полку игр.
  
-Нам не нужно, чтобы все ​игры, которые мы хотим запускать с нашего сайта лежали прямо у нас на сайте. Мы можем запускать ​игрыкоторые ​лежат на других сайтах.+Открыть таким же образом игру в онлайн-плеерев котором нет полки игр (то есть в плеере для стандалон-сборки)не получится.
  
-Например, **qSpider** у нас установлен по адресу "''​**%%https://​qspfoundation.github.io/​qspider%%**''"​, а игра лежит по адресу "''​%%https://​aleksversus.narod.ru/​arch/​verenitsa_mirov.zip%%''"​.+Таким же образом можно загружать игры целым ​пакетомсославшись на один конфигурационный файл (конфиг), в котором описаны сразу несколько игр:
  
-Мы можем ввести в адресную строку,​ или вставить в атрибут ''​**href**''​ гиперссылки следующий адрес, и он откроет нашу игру в указанном плеере **qSpider**:​ +<​sxh>​ 
- +https://​qspfoundation.github.io/​qspider/?​config=https://​aleksversus.github.io/QSP-storage/game/game.cfg
-<​sxh ​html+
-https://​qspfoundation.github.io/​qspider/?​game=https://​aleksversus.narod.ru/arch/verenitsa_mirov.zip+
 </​sxh>​ </​sxh>​
  
-Таким же образом можно загружать конфигурационные файлы:+После загрузки всех игр на полку, самая первая игра ​в конфиге будет запущена автоматически.
  
-<sxh html> +А ещё можно упаковать несколько игр в zip-архив,​ поместить в корень архива конфигурационный файл, и сделать ссылку на архив — все игры из архива тоже будут загружены на полку. 
-https://qspfoundation.github.io/qspider/?config=https://​qspfoundation.github.io/​qspider/​game/​game.cfg + 
-</​sxh>​+==== Запуск игр из каталога по ссылке ==== 
 + 
 +Игру, опубликованную в каталоге игр qsp.org, можно запускать по прямой ссылке. Она автоматически добавится на полку и запустится. Чтобы получить такую ссылку:​ 
 + 
 +  * откройте страницу с игрой на сайте 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.1681923737.txt.gz · Последние изменения: 2023/04/19 17:02 — aleks_versus