Идеи и функции для игры

Ваша следующая функция

Общие объекты

Делитесь неинтерпретируемыми игровыми данными с помощью явных политик доступа, индексированных запросов и исходных ревизий.

SDK: developТребуется сессия игрока
Godot
Иллюстрация функции «Общие объекты»
Видимый результат

Перед созданием получите данные об использовании владельца. Создание использует их ревизию; обновление и удаление используют исходную ревизию объекта. Владелец, группа и срок истечения, заданный при создании, не меняются.

Видео появится позже

Для этого шага пока нет видео. Инструкция и запрос MCP уже доступны.

Общие объекты

Подготовьте тот же проект

  1. Выберите в панели тот же проект, что указан в конфигурации игры.

    Общие объекты →
  2. Создайте или используйте эти тестовые записи в форме панели. Это примеры значений, а не текущие данные проекта.

    Ключ
    bases
    Политика чтения
    all
    Политика записи
    owner
    Позиция в сетке
    true
    Максимум байт на объект
    1024
    Максимум объектов на владельца
    1

    Ключи остаются зарезервированными. После первого использования политики, схема поиска, TTL и позиция неизменяемы. Архивирование блокирует новые записи; чтение и удаление остаются доступны.

    Первый пример читает данные. Он не создаёт группу, матч или объект. Пустой список является допустимым первым ответом.

  3. Сохраните, загрузите заново и проверьте записи до запуска примера. Сохраните остальные определения.

Добавьте эту функцию

Вы можете просмотреть руководство. Для выполнения нужен активный ключ проекта. Подготовить проект

SDK установлен, конфигурация проекта импортирована, игрок вошёл в систему.

Этот пример SDK использует develop. Проверьте наличие нужных API в установленном SDK.

Завершите подключение нужного игрока по быстрому старту. Вызовите read_world_map() явной кнопкой или действием сцены. Открытие файла само по себе запрос не отправляет.

GDScript
res://scripts/shared_objects.gd
Вызов horizOn
1extends Node
2​
3# Verified SDK Develop API. Call explicitly after restoring the existing player.
4func read_world_map() -> void:
5 var user = Horizon.auth.getCurrentUser()
6 if user == null:
7 return
8 var result = await Horizon.sharedObjects.queryObjects(user.userId, "bases", {
9 "mode": "rectangle", "minX": -10, "maxX": 10,
10 "minY": -10, "maxY": 10, "limit": 20
11 })
12 if not result.success:
13 push_warning(result.errorCode)
14 return
15 for object in result.data.objects:
16 var bytes: PackedByteArray = object.data
17 print(object.id, " bytes=", bytes.size())
18 # Respect result.data.pollAfterSeconds; no automatic poll or page loop.
19 # Keep dataBase64 and lossless search-string wrappers unchanged on metadata edits.
20 # Mutations need durable original bytes, IDs and If-Match revision before one send.
21 # An unknown create is reconciled through getRecoveryUsage/queryRecoveryObjects.
22 # No new identity, replacement revision or automatic create retry.
Открыть полный пример SDK ↗

Карта мира

Храните базы владельцев как неинтерпретируемые байты. Явно запрашивайте настроенный прямоугольник сетки с целочисленными координатами; обновляйте с исходной ревизией объекта. Позиция служит индексом запросов и не проверяет правила игры.

Асинхронное PvP

Выберите противника ограниченным целочисленным запросом с неравномерным распределением. Загрузите его байты защиты и проверьте игру через запуск Validated Actions под управлением сервера. Только доверенный бэкенд определяет результат и отправляет неизменяемое уведомление Inbox.

Используйте соответствующие сессии игроков, надёжно сохранённое исходное намерение записи и явные ограниченные чтения. Доверенная проверка результата и доставка Inbox выполняются на бэкенде игры; Account Keys никогда не должны попадать в сборки игры.

Проверьте новую функцию.

Перед созданием получите данные об использовании владельца. Создание использует их ревизию; обновление и удаление используют исходную ревизию объекта. Владелец, группа и срок истечения, заданный при создании, не меняются.

Выберите в панели тот же проект, что указан в конфигурации игры.

Эндпоинты
  • GET/shared-objects/collections
  • GET/shared-objects/{collection}/usage
  • GET/shared-objects/{collection}/objects/{objectId}
  • POST/shared-objects/{collection}/query
  • POST/shared-objects/{collection}/objects
  • PUT/shared-objects/{collection}/objects/{objectId}
  • DELETE/shared-objects/{collection}/objects/{objectId}
Все эндпоинты в справочнике API
Иллюстрация функции «Рейтинги»
Наше предложение для следующего шага

Добавьте рекорд для каждого раунда.

Сохраняйте результат после раунда и показывайте лидеров. Продолжайте использовать подключение и сессию игрока.