Language Packs

Note: You are viewing the Native version of this topic. To view this topic for Unity development, see Language Packs (Unity). To view this topic for Unreal development, see Language Packs (Unreal).

Language Packs enable you to provide additional languages with your app without increasing the initial download size.

These files are uploaded to the Oculus store when you upload your app package.

Overview

On Rift, providing language packs as downloadable assets will decrease initial download size. The Skyline Desktop App for Rift will allow users to select which language pack they want to use from the Details page.

The following image shows an example of how this looks.

On Quest, providing language packs as downloadable assets will decrease initial download size.

Developers will have to implement their own language picker in an app. Then, users will be able to select a language to use within that application, which will download the appropriate langauge pack.

Check for Language Packs in App Code has more information that will be helpful for creating a language picker.

For Oculus to correctly recognize your language pack you should name it with a language code per BCP47 format, with a suffix of “lang”. For example en-us.lang and de.lang would be valid language pack names.

Upload a Binary with Language Packs to the Oculus Store

You must use the Oculus Platform Command Line Utility to upload a binary with assets or language packs.

For language packs, use the --language_packs_dir parameter to specify the directory that contains the language packs.

Important

When you upload new apps that have accompanying asset files, make sure the asset files have the same name as previously uploaded versions of the same file.

Here is a sample command to upload a Rift package with a langauge pack:

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

Here is a sample command to upload a Quest package with a langauge pack:

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

View Language Packs on the Dashboard

Once you successfully upload your items, you can view and manage them on the developer dashboard. Navigate to the Developer Dashboard. On the left menu, select your org, and select your app and click on its Expansion Files. Then find the Expansion Files column for the build you just uploaded and then select View Expansion Files. The different kinds of assets will display.

  • Look for Language Packs.

The following image shows an example.

Asset File Dashboard

Check for Language Packs in Your App Code

Use the following steps to check for language packs in your app code.

  1. Use the ovr_AssetFile_GetList function to get a list of all assets.
  2. Check for an asset type with the GetAssetType function of AssetDetails. A language pack will be of type language_pack.
  3. Use the GetLanguage function to get the language of the asset.