Note: You are viewing the Unity version of this topic. To view this topic for native development, see Language Packs (Native). 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.
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.
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.
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
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.
The following image shows an example.
Use the following steps to check for language packs in your app code.
Platform.AssetFile.GetList
function to get a list of all assets.AssetDetails
. A language pack will be of type language_pack
.