Version: 2021.3
LanguageEnglish
  • C#

PlayerSettings.SetPlatformIcons

Suggest a change

Success!

Thank you for helping us improve the quality of Unity Documentation. Although we cannot accept all submissions, we do read each suggested change from our users and will make updates where applicable.

Close

Submission failed

For some reason your suggested change could not be submitted. Please <a>try again</a> in a few minutes. And thank you for taking the time to help us improve the quality of Unity Documentation.

Close

Cancel

Switch to Manual

Declaration

public static void SetPlatformIcons(Build.NamedBuildTarget buildTarget, PlatformIconKind kind, PlatformIcon[] icons);

Declaration

public static void SetPlatformIcons(BuildTargetGroup platform, PlatformIconKind kind, PlatformIcon[] icons);

Parameters

platform The full list of platforms that support this API the supported kinds can be found in icon kinds.
icons All available PlatformIcon slots must be retrieved with GetPlatformIcons.
buildTarget The NamedBuildTarget.

Description

Assign a list of icons for the specified platform and icon kind.

Most platforms support icons with several different sizes. This methods allows you to set Icons for each platform that supports them. GetPlatformIcons has to be used to retrieve all the supported icons for specified PlatformIconKind and platform. Texture files must be stored in the project and instances obtained using AssetDatabase.LoadAssetAtPath.

BuildTargetGroup is marked for deprecation in the future. Use NamedBuildTarget instead.

The following code sample shows how to set up adaptive icons for an Android application. This is an editor script which means it must be within an Editor folder to compile.

using UnityEditor.Android;
using UnityEditor;
using UnityEngine;
using UnityEditor.Build;

public static class AndroidPlayerSettingsUtility { // `Adaptive` icons for Android require a background and foreground layer for each icon public static void SetIcons(Texture2D[][] textures) { NamedBuildTarget platform = NamedBuildTarget.Android; PlatformIconKind kind = AndroidPlatformIconKind.Adaptive;

PlatformIcon[] icons = PlayerSettings.GetPlatformIcons(platform, kind);

//Assign textures to each available icon slot. for (int i = 0; i < icons.Length; i++) { icons[i].SetTextures(textures[i]); } PlayerSettings.SetPlatformIcons(platform, kind, icons); } }

The following code sample shows how to set all App icons for an iOS application. This is an editor script which means it must be within an Editor folder to compile.

using UnityEditor.iOS;
using UnityEditor;
using UnityEngine;
using UnityEditor.Build;

public static class iOSPlayerSettingsUtility { // Setting all `App` icons for iOS public static void SetAppIcons(Texture2D[] textures) { NamedBuildTarget platform = NamedBuildTarget.iOS; PlatformIconKind kind = iOSPlatformIconKind.Application;

PlatformIcon[] icons = PlayerSettings.GetPlatformIcons(platform, kind);

//Assign textures to each available icon slot. for (int i = 0; i < icons.Length; i++) { icons[i].SetTextures(textures[i]); } PlayerSettings.SetPlatformIcons(platform, kind, icons); } }