Language Packs

ovr-platform-util upload-rift-build -a 12345 -s 1234 -d path/to/mygame.zip  --language_packs_dir /path/to/myGame/language-packs -c ALPHA

ovr-platform-util upload-quest-build -a 12345 -s 1234 -d path/to/mygame.zip  --language_packs_dir /path/to/myGame/language-packs -c ALPHA

1. Navigate to the Meta Horizon Developer Dashboard⁠.
2. In the top-right corner of the Meta Horizon Dashboard, select your org.
3. Select your app.
4. In the left-side navigation, select Distribution > Builds. A list of all builds for your app appears.
5. In the Build column, click on a build.
6. Select the Expansion Files tab.
7. Find the Expansion Files column for the build you selected and then select View Expansion Files. The different kinds of assets will display.
8. Look for Language Packs.
   The following image shows an example of language packs.
   

1. Use the Platform.AssetFile.GetList() function to get a list of all assets.
2. Check for an asset type via the Platform.Models.AssetDetails.AssetType property. A language pack has the asset type language_pack.
3. Read the language of the asset from the nullable Platform.Models.AssetDetails.LanguageOptional property, whose Tag field holds the BCP47 language code.

using Oculus.Platform;
using Oculus.Platform.Models;

Request<AssetDetails> request = LanguagePack.GetCurrent();
if (request == null) { return; }
request.OnComplete(message =>
{
    if (message.IsError) { return; }
    AssetDetails details = message.Data;
    if (details == null || details.LanguageOptional == null) { return; }
    string tag = details.LanguageOptional.Tag;
    string path = details.Filepath;
});

AssetFile.SetDownloadUpdateNotificationCallback(message =>
{
    if (message.IsError) { return; }
    AssetFileDownloadUpdate update = message.Data;
    if (update == null) { return; }
    if (update.BytesTransferred < 0 || update.BytesTotal == 0) { return; }
    float progress = (float)update.BytesTransferred / update.BytesTotal;
});

// languagePackAssetId is a ulong field on your picker, not a local in the callback.
Request<AssetFileDownloadResult> request = LanguagePack.SetCurrent("de");
if (request == null) { return; }
request.OnComplete(message =>
{
    if (message.IsError) { return; }
    AssetFileDownloadResult result = message.Data;
    if (result == null) { return; }
    languagePackAssetId = result.AssetId;
});

• A delay between requests, so the loop does not spin.
• A bound, either a maximum number of attempts or a timeout, so a pack that never reaches installed does not hold the loop open.
• A cancellation path, so leaving the picker ends the loop.
• Error handling on every response, so a failed request retries or ends the loop rather than reading as a status that is not installed.

// installedPath is a string field on your picker.
Request<AssetDetails> request = AssetFile.StatusById(languagePackAssetId);
if (request == null) { return; }
request.OnComplete(message =>
{
    if (message.IsError) { return; }
    AssetDetails details = message.Data;
    if (details == null) { return; }
    if (details.DownloadStatus == "installed")
    {
        installedPath = details.Filepath;
    }
});

1. List every asset file, as described in Check for language packs in your app. Keep the entries whose asset type is the string language_pack. The list call takes no filter parameter, so filter the results in your app code. This gives you the entry list.
2. Label each entry from the names on its language info: the English name, for a list that stays readable to a user who selected the wrong language, and the native name, for the spelling used by that language. This gives you the display text.
3. Call get-current and pre-select the entry whose tag matches the tag it returns. This gives you the starting selection.
4. Start progress observation, then call set-current with the tag of the entry the user selects. Store the asset ID from the result in your picker state. This gives you the asset ID.
5. Request the asset status in your bounded loop until the download status is installed. Store the filepath from that response. This gives you the filepath.
6. Reload your localized content from the stored filepath, then end the progress observation.

Request<AssetDetailsList> request = AssetFile.GetList();
if (request == null) { return; }
request.OnComplete(message =>
{
    if (message.IsError) { return; }
    AssetDetailsList assets = message.Data;
    if (assets == null) { return; }
    foreach (AssetDetails asset in assets)
    {
        if (asset.AssetType != "language_pack" || asset.LanguageOptional == null) { continue; }
        string label = $"{asset.LanguageOptional.EnglishName} ({asset.LanguageOptional.NativeName})";
    }
});