Проверка прав на использование приложений Магазина Meta

• Синхронный: Platform.Core.Initialize()
• Асинхронный: Platform.Core.AsyncInitialize()

Platform.Core.AsyncInitialize(appID)

Platform.Entitlements.IsUserEntitledToApplication().OnComplete(callbackMethod);

void callbackMethod (Message msg)
{
  if (!msg.IsError)
     {
       // Entitlement check passed
     }
        else
     {
       // Entitlement check failed. Quit app
     }
 }

• Для Android-приложений используйте AsyncInitialize(), а не Initialize(). Это важно, потому что AsyncInitialize() не блокирует код инициализации, что позволяет приложению загружаться быстрее. Кроме того, AsyncInitialize() не вызывает исключение на Android в случае неудачной инициализации.
• Поместите код инициализации API платформы в блок try/catch и рассматривайте все перехваченные исключения так, как если бы проверка права на использование не была пройдена.
• Задайте ID приложения в OculusPlatformSettings в редакторе Unity (Meta > Platform (Платформа) > Edit Settings (Редактировать настройки)) или вызовите AsyncInitialize() с явным аргументом AppId. Для мобильных разработчиков: если вам нужно запускать мобильные приложения в редакторе Unity, укажите в OculusPlatformSettings учетные данные Meta (имя пользователя и пароль). Прост задать ID приложения будет недостаточно.

using UnityEngine;
using Oculus.Platform;

public class AppEntitlementCheck : MonoBehaviour
{
    void Awake()
    {
        try
        {
            Core.AsyncInitialize().OnComplete(InitializeCallback);
        }
        catch (UnityException e)
        {
            Debug.LogErrorFormat("Platform failed to initialize due to exception: %s.", e.Message);
            UnityEngine.Application.Quit();
        }
    }

    void InitializeCallback(Message msg)
    {
        if (msg.IsError)
        {
            var err = msg.GetError();
            Debug.LogErrorFormat("Platform failed to initialize due to exception: %s.", err.ToString());
            UnityEngine.Application.Quit();
        }
        else
        {
            Entitlements.IsUserEntitledToApplication().OnComplete(EntitlementCallback);
        }
    }

    void EntitlementCallback(Message msg)
    {
        if (msg.IsError)
        {
            // Implements a default behavior for an entitlement check failure -- log the failure and exit the app.
            // Going into a limited demo mode, or displaying an error, is also valid.
            var err = msg.GetError();
            Debug.LogErrorFormat("Entitlement check failed: %s.", err.ToString());
            UnityEngine.Application.Quit();
        }
        else
        {
            Debug.Log("You are entitled to use this app.");
        }
    }
}

POST https://graph.oculus.com/$APP_ID/verify_entitlement

curl -d "access_token=OC|$APP_ID|$APP_SECRET" -d "user_id=$USER_ID" https://graph.oculus.com/$APP_ID/verify_entitlement

{"success":true,"grant_time":1744148687}

1. В редакторе перейдите в Meta > Platform (Платформа) > Edit Settings (Редактировать настройки) и замените App ID произвольной строкой цифр.
   
2. Попробуйте выполнить проверку прав в редакторе или соберите APK и протестируйте на гарнитуре.
3. Проверка прав должна завершиться ошибкой.

• Проверку прав проходят только тестовые пользователи из команды тестируемого приложения. У тестовых пользователей, связанных с другой командой, нет необходимых прав для доступа к приложению, что приводит к ошибке проверки.
• Публикация новой версии приложения. На права может повлиять публикация новой версии приложения. Чтобы повторно запустить процесс проверки прав, убедитесь, что все пользователи находятся в правильных каналах и что новая версия имеет более высокий номер.
• Необходимость загрузки APK в канал для создания начального сопоставления имени пакета -> ID приложения. Для нового приложения начальное сопоставление имени пакета и идентификатора приложения устанавливается при первой загрузке APK в канал. Если этот шаг не выполнен, проверка прав не пройдет, поскольку система не сможет проверить права доступа из-за отсутствия соответствующего сопоставления. Чтобы узнать, как найти название пакета, обратитесь к следующему вопросу.
• Несоответствие ID приложения и названия пакета. После того как ID приложения будет сопоставлен с названием пакета, в случае несоответствия между сообщаемым ID приложения и названием пакета приложения, выполняющего проверку прав, и зафиксированным системой названием пакета для этого ID приложения, система не сможет правильно идентифицировать и подтвердить связанные с приложением права. Убедитесь, что используемый ID приложения соответствует имени пакета в манифесте приложения. Чтобы узнать, как найти название пакета, обратитесь к следующему вопросу.
• Назначение пользователей и тестовых пользователей в правильные каналы. Для доступа к определенным приложениям пользователи и тестовые пользователи должны быть назначены в правильные каналы. Это гарантирует, что у них будут права на использование приложения и доступ к его функциям и контенту.

1. Перейдите на Панель разработчика Meta Horizon⁠.
2. Выберите приложение.
3. В левой области навигации выберите Распространение > Сборки.
4. На странице Сборки в столбце Сборка нажмите гиперссылку версии сборки, которую нужно просмотреть.
5. На странице Сборки > № версии на вкладке Сведения вы найдете название пакета.