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.10.1] - 2023-05-31

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

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

Fixed

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

[1.8.1] - 2023-03-01

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

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

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

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

Fixed

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

[1.5.1] - 2022-10-06

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

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

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

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

Fixed

• NSUserDefaults handling null values

[1.4.1] - 2022-05-20

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

Added

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

[1.3.2] - 2022-04-14

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

Changed

• Newtonsoft package dependency update to 3.0.2.

[1.3.0] - 2022-03-21

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

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

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

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

Added

• Getter methods for ConfigurationBuilder.

Fixed

• Fix layout for Project Bind Redirect Popup for Light theme

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

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

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

Added

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

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

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

Added

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

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