Changelog

All notable changes to this package will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[1.14.0] - 2024-11-06

Add version 1.14.0 by name.

Added

  • Added ServicesInitialization monobehaviour to manage services in the scene authoring.
  • Added ServicesBehaviour abstract monobehaviour as a base for behaviours built on top of services.
  • Added unique identifier for custom service registry creation (UnityServices.CreateServices).
  • Added custom services registries dictionary in UnityServices.Services.
  • Added GetIdentifier() method to IUnityServices interface with a default implementation.

Changed

  • Updated the minimum supported Editor version to 2021.3.

[1.13.1] - 2024-10-17

Add version 1.13.1 by name.

Added

  • Refresh button for Environment dropdown in Project Settings > Services > Environments menu.

Fixed

  • Fixed user permissions fetching for cloud projects where the user has the 'inherited from organization' role.

Changed

  • The EnvironmentProvider, EnvironmentSaveSystem, EnvironmentService, and related interfaces have been updated to support an object representing the environment (name and id) instead of a string representing the environment name.

[1.13.0] - 2024-06-10

Add version 1.13.0 by name.

Added

  • Added initialization success and failure events to UnityServices.

[1.12.5] - 2024-04-02

Add version 1.12.5 by name.

Added

  • Apple privacy manifest file (PrivacyInfo.xcprivacy)

Fixed

  • Fixed an issue with the optional FEATURE_SERVICES_INSTANCES preprocessor define.

[1.12.4] - 2024-02-29

Add version 1.12.4 by name.

Fixed

  • Fixed a bug where the project linking popup window would appear on Editor start after reimporting packages, even if the user's project was linked.
  • Fixed issue with .NET Standard target.

[1.12.2] - 2024-01-10

Add version 1.12.2 by name.

Added

  • Added support to -no-cloud-project-bind-popup flag, to prevent the popup from showing.

Fixed

  • The Environment Selector no longer throws exceptions when there is no network connection, instead it displays a different offline UI

[1.12.1] - 2023-11-16

Add version 1.12.1 by name.

Changed

  • Rolling back interface constraint in service registry due to unforeseen breaking change with transitive dependencies.

[1.12.0] - 2023-10-20

Add version 1.12.0 by name.

Added

  • Added service registry and new package initialization interface for enabling instances and editor-time services.

Fixed

  • Resolved issue with IAccessTokens reaching rate limit.

[1.11.0] - 2023-07-31

Add version 1.11.0 by name.

Added

  • Adding IServerAccessToken and IServerEnvironmentId components for packages that want to support running operations in the context of a server.
  • Adding IAccessTokenObserver component for packages to be notified of changes to the IAccessToken value.

Fixed

  • Implement JsonConverters to prevent NotImplementedException when converters are invoked by reflection

[1.10.2-pre.2] - 2023-06-14

Add version 1.10.2-pre.2 by name.

Added

  • Added support for the environments UI to Unity Editor 2020.3

[1.10.1] - 2023-05-31

Add version 1.10.1 by name.

Added

  • The IAnalyticsUserId component to provide a way to obtain the user ID that the analytics SDK is currently recording events against.
  • Added new environment selector in Project Settings > Services > Environments.
  • Added new environment api to allow services to use a single access point for the current environment.

[1.9.0] - 2023-05-09

Add version 1.9.0 by name.

Added

  • New common error codes ProjectPolicyAccessDenied and PlayerPolicyAccessDenied.

Changed

  • Newtonsoft (de)serialization calls to be thread safe.
  • Bumped Newtonsoft dependency to 3.2.1 to use the latest stable version.

[1.8.2] - 2023-04-04

Add version 1.8.2 by name.

Fixed

  • Newtonsoft usage isn't impacted by changes to JsonConvert.DefaultSettings anymore.

[1.8.1] - 2023-03-01

Add version 1.8.1 by name.

Added

  • The IAnalyticsStandardEventComponent component to provide a way to record analytics standard events from any package.

Changed

  • Package's license to refresh legal links.

[1.7.1] - 2023-01-30

Add version 1.7.1 by name.

Changed

  • Improved assembly filtering when generating the link file to only link assemblies providing a IServiceComponent.

Fixed

  • ActionScheduler doesn't generate GC allocation (used to be 40 bytes) each frame anymore.
  • Failed telemetry request no longer log errors when they fail, unless ENABLE_UNITY_SERVICES_CORE_TELEMETRY_LOGGING is enabled as scripting define.
  • All ActionScheduler registered during play mode are now properly unregistered when exiting playmode.

Added

  • A link.xml generator to make sure all required service assemblies are properly preserved in build with code stripping enabled.

[1.7.0] - 2022-11-25

Add version 1.7.0 by name.

Fixed

  • Improved thread safety for scheduler component. IActionScheduler is now safely callable from any thread.
  • Improved thread safety for telemetry components. IMetrics and IDisagnostics are now safely callable from any thread.

Changed

  • Editor AccessTokens now caches the Gateway JWT per session and refreshes it as needed. It can now be used directly without needing to cache the results.

[1.6.0] - 2022-10-31

Add version 1.6.0 by name.

Changed

  • Services configuration file isn't temporarily added to the StreamingAssets folder during builds on Unity 2021.3 and up.
  • Services initialization without a linked project id will fail (throw UnityProjectNotLinkedException).

Fixed

  • Persisting telemetry no longer logs errors, unless ENABLE_UNITY_SERVICES_CORE_TELEMETRY_LOGGING is enabled as scripting define. Diagnostics are sent when persisting telemetry produces an error.

[1.5.2] - 2022-10-17

Add version 1.5.2 by name.

Fixed

  • Core will no longer fail initialization when it fails to find a stripped service package.

[1.5.1] - 2022-10-06

Add version 1.5.1 by name.

Added

  • UnityServices.ExternalUserId which can be used to pass a user identifier from a third party provider to Unity Gaming Services

Fixed

  • Services Core failing to find all IInitializablePackage if an unity package implements it multiple times.

[1.5.0] - 2022-10-03

Add version 1.5.0 by name.

Added

  • All IInitializablePackage initialization time is now measured by Services Core.

Changed

  • CoreRegistryInitializer now throws a ServicesInitializationException instead of an explicit NullReferenceException when the dependency tree is null.
  • ActionScheduler updated to be thread safe

Fixed

  • A case where null configuration values were causing serialization issues
  • Issue with stripping when authentication APIs are not used.

[1.4.3] - 2022-07-28

Add version 1.4.3 by name.

Fixed

  • Added diagnostic message length limit and telemetry count limit, so telemetry payload will not be rejected by telemetry service.

Changed

  • Telemetry logs now use the ENABLE_UNITY_SERVICES_CORE_TELEMETRY_LOGGING define instead of ENABLE_UNITY_SERVICES_CORE_VERBOSE_LOGGING.

[1.4.2] - 2022-06-16

Add version 1.4.2 by name.

Changed

  • Log error instead of warning when core initialize with no cloud project id

Added

  • Log a JSON containing the common configuration shared among all services for debugging purposes when using ENABLE_UNITY_SERVICES_CORE_VERBOSE_LOGGING as a scripting define.
  • Log warning when building a project with core package included and without linking the project in project settings.

Fixed

  • NullReferenceException while telemetry was provided an empty file, fixed by introducing a null check
  • DirectoryNotFoundException happened inconsistently on Switch, fixed by resolving racing condition issue

[1.4.2-pre.2] - 2022-05-27

Add version 1.4.2-pre.2 by name.

Fixed

  • NSUserDefaults handling null values

[1.4.1] - 2022-05-20

Add version 1.4.1 by name.

Added

  • Log warning when core initialize with no cloud project id
  • Add a message in "Link your unity project" popup to inform the user has to sign-up

[1.4.0] - 2022-04-29

Add version 1.4.0 by name.

Added

  • Add Vivox public interfaces: IVivox, IVivoxTokenProviderInternal, to enable interactions with the Vivox service.

[1.3.2] - 2022-04-14

Add version 1.3.2 by name.

Fixed

  • Crash on Switch when initializing telemetry persistence. Now telemetry won't persist anything on Switch.
  • NullReferenceException while linking the project
  • Issue with user roles and service flags

[1.3.1] - 2022-03-29

Add version 1.3.1 by name.

Changed

  • Newtonsoft package dependency update to 3.0.2.

[1.3.0] - 2022-03-21

Add version 1.3.0 by name.

Added

  • Add QoS public interface: IQosResults and return type QosResult, to provide QoS functionality to other packages

Fixed

  • Code stripping when core package is not used
  • Retrying to initialize all services after a first attempt failed.

[1.2.0] - 2022-02-23

Add version 1.2.0 by name.

Added

  • Add Wire public interfaces: IWire, IChannel, IChannelTokenProvider, and their dependencies, to enable interactions with the Wire service.
  • The IUnityThreadUtils component to simplify working with the Unity thread.

Changed

  • Newtonsoft dependency to use the latest major Newtonsoft version, 13.0.1.

[1.1.0-pre.69] - 2022-02-17

Add version 1.1.0-pre.69 by name.

Added

  • Add IEnvironmentId component to provide the environment ID from the Access Token to other packages
  • OrganizationProvider & IOrganizationHandler to enable package developers to access Organization Key.

[1.1.0-pre.41] - 2021-12-08

Add version 1.1.0-pre.41 by name.

Added

  • IDiagnosticsFactory component & IDiagnostics to enable package developers to send diagnostics for their package.
  • Add AnalyticsOptionsExtensions with SetAnalyticsUserId(string identifier) to set a custom analytics user id.
  • IMetricsFactory component & IMetrics to enable package developers to send metrics for their package.

Fixed

  • Calling UnityServices.InitializeAsync(null) throwing a null reference exception.

[1.1.0-pre.11] - 2021-10-25

Add version 1.1.0-pre.11 by name.

Added

  • Getter methods for ConfigurationBuilder.

Fixed

  • Fix layout for Project Bind Redirect Popup for Light theme

[1.1.0-pre.10] - 2021-10-08

Add version 1.1.0-pre.10 by name.

Added

  • IActionScheduler component to schedule actions at runtime.
  • ICloudProjectId component to access cloudProjectId.

Removed

  • Removed the Service Activation Popup

Fixed

  • Fix define check bug on Android and WebGL

[1.1.0-pre.9] - 2021-09-24

Add version 1.1.0-pre.9 by name.

Added

  • New common error codes: ApiMissing, RequestRejected, NotFound, InvalidRequest.
  • Link project pop-up dialog

Fixed

  • Core registry throwing exceptions when domain reloads are disabled

[1.1.0-pre.8] - 2021-08-06

Add version 1.1.0-pre.8 by name.

Added

  • Added base exception type for other Operate SDKs to derive from. Consistent error handling experience.

[1.1.0-pre.7] - 2021-08-06

Add version 1.1.0-pre.7 by name.

Added

  • UnityServices class at runtime. It is the entry point to initialize unity services with InitializeAsync() or InitializeAsync(InitializationOptions).
  • InitializationOptions to enable services initialization customization through code.
  • IInstallationId component to access the Unity Installation Identifier.
  • IEnvironments component to get the environment currently used by services.
  • SetEnvironmentName initialization option to set the environment services should use.
  • MiniJson.
  • IProjectConfiguration component to access services settings at runtime.
  • IConfigurationProvider to provide configuration values that need to be available at runtime.

[1.0.1] - 2021-06-28

Add version 1.0.1 by name.

Added

  • DevEx integration into the editor.
  • Service Activation popup.

This is the first release of com.unity.services.core.

Did you find this page useful? Please give it a rating: