Разработка

Выберите платформу

Обзор мест назначения

Apps for children can't use Platform SDK features

Если вы самостоятельно обозначаете возрастную группу и объявляете, что ваше приложение предназначено в первую очередь для детей младше 13 лет, вы не должны пользоваться функциями Platform SDK. Это ограничение обеспечивает соблюдение требований для определенных возрастов. Чтобы гарантировать это, функция проверки использования данных для вашего приложения будет отключена.

Места назначения — это места проведения общественных мероприятий в вашем иммерсивном приложении. Они могут принимать различные формы, например многопользовательский сервер, пул подбора игроков или определенную конфигурацию действия. С этими местами назначения можно связать мультимедийные материалы, такие как изображения, переведенные описания и метаданные (например, ограничения для проигрывателей). Каждому месту назначения будет присвоен URL-адрес, который можно использовать для публикации новых уровней или игровых режимов в социальных сетях. Магазин Meta Horizon может отображать эти направления на странице вашего магазина приложений и на странице вечеринок в качестве рекомендуемых занятий, позволяя пользователям окунуться в увлекательное приключение всего одним щелчком мыши.

Направления имеют важное значение для многопользовательских функций, и первый шаг к созданию любого многопользовательского приложения — интеграция мест назначений, группового присутствия и глубоких ссылок через соответствующие API. Эти API работают вместе, стимулируя социализацию и обмен опытом, что привлекает больше пользователей к вашему приложению. Каждый из этих API делает ваши игры более интерактивными, позволяя пользователям перемещаться к местам назначения в одиночку или с друзьями. При совместном использовании эти функции позволяют делиться местоположениями на платформе, на странице вашего приложения в магазине и даже в социальных сетях.

Для создания мест назначения для вашего приложения необходимо создать приложение и загрузить его на панель инструментов разработчика.

Глубокие ссылки

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

Всякий раз, когда пользователь запускает ваше приложение, чтобы присоединиться к кому-то или перейти к пункту назначения, глубокая ссылка содержит информацию о желаемом пункте назначения. Также имеется необязательное поле сообщения с глубокой ссылкой для указания дополнительных данных. Пользователи могут перейти со страницы вашего магазина приложений на страницу человека или в место в вашем приложении одним щелчком мыши. Глубокие ссылки можно распространять на социальных платформах, что повышает вовлеченность пользователей в ваше приложение за пределами VR.

Интерфейс пользователя

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

Например, представьте себе ситуацию, когда вы добавляете в свою игру новую карту. С групповым присутствием, пунктами назначения и глубокими ссылками:

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

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

Двое друзей могут одновременно запустить ваше приложение, перейти на новую карту и играть вместе.

Места назначения можно настроить так, чтобы они предоставляли наиболее релевантный контекст в зависимости от активности пользователя и возможности присоединения к нему. Например, место назначения может помочь пользователям найти соперника в игре 1 на 1 или предоставить хаб для направления пользователей в лобби приложения.

Определение одного или нескольких мест назначения для вашего приложения позволяет реализовать функцию присутствия в группе, на которую затем можно будет ссылаться.

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

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

Создание одного места назначения на панели разработчика

Места назначения можно создавать через панель разработчика. Несколько мест назначения одновременно можно также создать с помощью функции массовой загрузки.

Откройте Панель инструментов разработчика Meta Horizon⁠ и выберите свое приложение.

В левой навигационной панели выберите Вовлеченность > Места назначения.

На странице Места назначения выберите Создать одно место назначения.

На странице Новое место назначения введите следующую информацию:

Отображаемое имя — название вашего места назначения. Оно будет отображаться через групповое присутствие пользователя.

Описание — подробное описание того, чего могут ожидать ваши пользователи по прибытии в место назначения.

Имя API — уникальное имя, которое вы будете использовать в коде при ссылке на место назначения. Может содержать буквенно-цифровые символы и символы подчеркивания (_). Не может содержать пробелы и другие специальные символы.

Примечание. Имя API всегда должно направлять пользователей к этому месту назначения.

Сообщение для глубокой ссылки — добавьте любые дополнительные данные, которые помогут пользователю перейти в нужное место в вашем приложении. Сообщение можно отформатировать по вашему желанию, но оно не должно содержать пробелов. Добавляйте его только в том случае, если использование имени API и ID сеанса лобби/матча не дает достаточных данных.

Тип глубокой ссылки — параметры, позволяющие указать, доступна ли для вашего места назначения внешняя глубокая скидка.

Включено (по умолчанию) — выберите "Включено", если это место назначения может быть запущено без присутствия конкретного пользователя в месте назначения, и ваше приложение правильно направляет пользователей в это место назначения. Например, глубокая ссылка на пункт назначения лобби должна перенаправлять пользователя в лобби приложения. Кроме того, если эта функция включена, место назначения может быть представлено в приложении на основе его релевантности или популярности.

Отключено — выберите "Отключено", если приложение не может разрешить глубокую ссылку на это место назначения или вы не хотите, чтобы место назначения отображалось. Например, в приватной комнате, которая позволяет друзьям присоединяться друг к другу и не должна рекламироваться, не следует включать функцию Direct Deep Linking.

Учебный курс — выберите "Учебный курс" в качестве типа места назначения, если это учебный курс и оно поддерживает прямые глубокие ссылки.

Аудитория — определяет, кто сможет просматривать место назначения после его одобрения.

Все — место назначения должно быть доступно всем.

Только для разработчиков — место назначения доступно только разработчикам внутри команды. Используйте его для тестирования разрабатываемых мест назначения. После выпуска места назначения переключитесь на "Все".

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

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

Примечание. Эта настройка необходима для группового запуска. Ваш пункт назначения не будет отображаться, если этот параметр не задан или если тип Deep Link не ВКЛЮЧЕН.

После ввода данных о месте назначения вы можете использовать кнопку Manage Languages (Управление языками), чтобы добавить языки для своего приложения. Для каждого дополнительного языка перед отправкой необходимо ввести локализованные данные о месте назначения.

Выберите категорию языка и введите локализованное отображаемое имя для этого языка. Это имя используется для отображения, например, статуса пользователя, а также для голосовых команд платформы, например "Открыть [место назначения] в [приложении]".

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

Если у вашего места назначения есть модификаторы, такие как уровень сложности или режим игры, используйте дефис. Например, если место назначения — Combat, а режим игры — Public, отображаемое имя будет Combat-Public.

Вы можете добавить несколько модификаторов к отображаемому имени. Если используется место назначения Crab Rave и модификаторы сложность Hard и условие No Arrows, то полное имя места назначения будет Crab Rave-Hard-No Arrows.

Дефис ставится не между каждым словом, а только между отображаемым именем и каждым модификатором.

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

Наконец, вы можете загрузить изображение вашего места назначения. Загружаемое изображение должно быть в формате PNG с разрешением 2 560 x 1 440, соотношением сторон 16:9 и глубиной цвета 24 бита. Изображение может быть обрезано, поэтому следует оставить пустое пространство по краям.

Когда всё будет готово, нажмите Отправить на проверку. Перед добавлением вашего места назначения в приложение оно должно быть одобрено. Вы можете отслеживать статус одобрения вашего места назначения в столбце Состояние отправки.

Создание нескольких пунктов назначения одновременно

Создавайте места назначения через панель разработчика. Можно создать несколько мест назначения одновременно.

Откройте Панель разработчика Meta Horizon⁠.

В левой навигационной панели выберите Вовлеченность > Места назначения, затем выберите свое приложение.

На странице Место назначения выберите Создать несколько мест назначений. Откроется диалоговое окно с шаблоном, который можно скачать. Поддерживается только формат файла TSV.

Файл TSV должен иметь следующие заголовки:

api_name: уникальное имя, которое вы будете использовать в коде при ссылке на место назначения. Может содержать буквенно-цифровые символы и символы подчеркивания (_). Не может содержать пробелы и другие специальные символы.

display_name_en_us: отображаемое имя для пункта назначения. Может содержать буквенно-цифровые символы и символы подчеркивания (_). Не может содержать пробелы и другие специальные символы. Добавьте новые столбцы (например, display_name_enGB) для отображаемых имен на разных языках. Список поддерживаемых языков см. ниже.

description_en_US: добавьте описание места назначения, чтобы помочь пользователям понять, куда они направляются. Может содержать буквенно-цифровые символы и символы подчеркивания (_). Не может содержать пробелы и другие специальные символы. Добавьте новые столбцы (например, description_en_GB) для отображаемых имен на разных языках. Список поддерживаемых языков смотрите ниже.

deeplink_type (по умолчанию: ВЫКЛЮЧЕНО)

ВКЛЮЧЕНО: выберите ВКЛЮЧЕНО, если это место назначения может быть запущено без присутствия конкретного пользователя в месте назначения, и ваше приложение правильно направляет пользователей в это место назначения. Например, глубокая ссылка на пункт назначения лобби должна перенаправлять пользователя в лобби приложения. Кроме того, если эта функция включена, место назначения может быть представлено в приложении на основе его релевантности или популярности.

ВЫКЛЮЧЕНО: выберите ВЫКЛЮЧЕНО, если приложение не может разрешить глубокую ссылку на этот пункт назначения или если вы не хотите, чтобы пункт назначения отображался. Например, в приватной комнате, которая позволяет друзьям присоединяться друг к другу и не должна рекламироваться, не следует включать функцию Direct Deep Linking.

УЧЕБНЫЙ КУРС: выберите УЧЕБНЫЙ КУРС в качестве типа назначения, если это учебный курс и оно поддерживает прямые глубокие ссылки.

deeplink_message (необязательно): добавьте любые дополнительные данные, которые помогут пользователю перейти в нужное место в вашем приложении. Сообщение можно отформатировать по вашему желанию, но оно не должно содержать пробелов. Добавляйте сообщение только в том случае, если использование имени API и ID сеанса лобби/матча не дает достаточных данных.

audience (по умолчанию: EVERYONE): определяет, кто должен иметь возможность просматривать место назначения после его одобрения.

EVERYONE: место назначения должно быть доступно всем.

DEVS: место назначения доступно только разработчикам внутри команды. Используйте его для тестирования разрабатываемых мест назначения. Переключитесь на Все, когда место назначения будет освобождено.

min_supported_group_launch (необязательно): для группового запуска минимальное количество пользователей, необходимое для совместного запуска.

max_supported_group_launch (необязательно): указывает максимальное количество пользователей, которые могут запуститься вместе. Если вы установите это значение, приложение будет отображаться в качестве рекомендации для вечеринок.

После одобрения созданных вами мест назначения вы можете редактировать или получить общий URL-адрес для вашего места назначения, открыв контекстное меню. Чтобы отредактировать место назначения или поделиться им, выполните следующие действия:

Откройте Панель разработчика Meta Horizon⁠.

В левой навигационной панели выберите Вовлеченность > Места назначения, затем выберите свое приложение. Найдите место назначения, которым вы хотите поделиться или которое хотите отредактировать, и нажмите многоточие (...) в крайнем правом столбце.

Выберите Перейти к месту назначения, чтобы посетить место назначения и получить URL-адрес из адресной строки браузера. Вы можете поделиться URL-адресом пункта назначения в социальных сетях и маркетинговых материалах вашего приложения. Этот целевой URL будет иметь следующий формат: https://oculus.com/vr/[app_id]/[destination_api_name].

Выберите Просмотреть/редактировать, чтобы просмотреть и изменить поля для вашего пункта назначения. Вы также можете выбрать Удалить, чтобы удалить место назначения.

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

Процесс отправки заявок для мест назначений

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

После отправки на утверждение вы можете отслеживать статус этой заявки по значению столбца "Состояние отправки" в таблице мест назначения на панели инструментов разработчика.

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

На следующем изображении показан пример полей "Статус отправки" и "Статус публикации", относящихся к новым отправкам.

Если место назначения уже был одобрено и опубликовано командой проверки контента, то и Состояние публикации, и Состояние отправки должны быть установлены на Опубликовано (см. место назначения "Матч" выше).

При обновлении ранее одобренного места назначения Состояние отправки места назначения устанавливается на Ожидает рассмотрения. Состояние публикации должно по-прежнему показывать, что оно "Опубликовано" (см. раздел назначение "Лобби" выше).

Для недавно добавленного места назначения, которое ещё не проверено командой проверки контента, Состояние отправки и Состояние публикации будут установлены на "Ожидание проверки" (см. место назначения "Битва с боссом" выше).

Критерии места назначения

Все заголовки, описания и изображения должны соответствовать Нормам сообщества⁠ Meta Quest.

Если включена внешняя глубокая ссылка, ожидается, что пользователь попадет в место назначения внутри приложения. Если установлено значение "Обучающий курс", то ожидается, что пользователь попадет на страницу обучающегося курса.

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