Документация Steamworks
Магазин предметов инвентаря Steam

Введение

Магазин предметов Steam (Steam Item Store) — настраиваемый интернет-магазин на платформе Steam, предназначенный для продажи предметов, определённых в службе инвентаря Steam. Если при определении предметов вы указали цены, вы просто можете активировать магазин предметов, где они будут перечислены.

item_store_example.jpg

После того, как магазин будет активирован, он будет представлять собой набор размещённых на серверах Steam веб-страниц с ценами на предметы, заданными в службе инвентаря. Пользователи смогут просматривать эти страницы, фильтровать и искать на них доступные в игре предметы, добавлять их в корзину и покупать, используя свой кошелёк Steam.

Создание магазина

Для начала вам потребуется иметь работающую реализацию службы инвентаря. После её настройки и определения предметов и их цен вы можете активировать магазин предметов для своего приложения.

  • Убедитесь, что служба инвентаря активирована для вашего приложения. См. раздел Служба инвентаря Steam, чтобы узнать больше.
  • Затем зайдите в раздел редактирования страницы в магазине и найдите вкладку магазина предметов.
  • Активируйте магазин предметов. Есть несколько параметров настройки внешнего вида магазина (см. ниже), но все они опциональны.

Когда магазин предметов будет активирован, вы можете открыть его страницу в оверлее Steam прямо из игры, вставив ссылку в браузер. Вы также можете дать ссылку на эту страницу на собственном веб-сайте. Самые продаваемые предметы автоматически появятся на странице игры в магазине Steam, чтобы пользователям было удобно находить их.

item_store_widget.jpg

Тестирование магазина предметов

По умолчанию магазин предметов видят только сотрудники партнёра Steamworks. Кроме того, покупки используют режим sandbox и не списывают средства с кошелька Steam. До выпуска для любых ссылок в магазине предметов используйте параметр beta=1 (например, https://store.steampowered.com/itemstore/<appid>/?beta=1).

Разработчики часто встречаются со следующими проблемами:
  • Предметы не показываются. Это может случиться, если в определениях предметов не установлены цены или в настройках раздела экономики в Steamworks не задан ключ сервера ресурсов.
  • Не удаётся оплатить покупку. Убедитесь, что вы задали ключ сервера ресурсов в разделе экономики Steam. Подробнее здесь.
  • Магазин предметов не видно. Магазин станет доступен для всех пользователей только после того, как вы выпустили приложение и вручную активировали магазин. Это можно сделать в настройках страницы в магазине вашего приложения.

Настройка внешнего вида магазина

Для магазина предметов можно установить фоновое изображение, выбрать один из двух вариантов расположения предметов (список или таблица), а также задать метки, которые на странице магазина отображаются как вкладки, которые используются для фильтрации предметов. В качестве примера выше приведён скриншот магазина предметов игры Rust, разработчики которой установили собственное фоновое изображение и добавили вкладки для поиска разных типов предметов.

Название магазина

Вы можете задать название магазина предметов, в том числе на разных языках. Если это поле оставить пустым, мы просто покажем название игры.

Расположение предметов на странице

Вы можете выбрать, как расположить предметы: списком (list) или в виде таблицы (grid).

Фоновое изображение

Вы можете загрузить фоновое изображение с элементами фирменного стиля игры, если вы хотите изменить общее ощущение от магазина. Изображение должно быть 1920 на 1080 пикселей, а края должны переходить в сплошной цвет, который вы также можете задать.

Фильтры верхнего уровня

Фильтр верхнего уровня можно соотнести с одной или несколькими метками, разделёнными точкой с запятой (;). Метки задаются при определении предмета в службе инвентаря в поле store_tags.

Страница просмотра изображений

Можно отобразить дополнительные изображения на странице с информацией о предмете, предоставив их определения в поле store_images при определении предмета в службе инвентаря. См. раздел «Схема службы инвентаря Steam».