{"id":1053,"date":"2025-10-30T18:03:52","date_gmt":"2025-10-30T18:03:52","guid":{"rendered":"https:\/\/docs.sisus.co\/init-args\/?p=1053"},"modified":"2025-10-31T08:05:20","modified_gmt":"2025-10-31T08:05:20","slug":"third-party-services","status":"publish","type":"post","link":"https:\/\/docs.sisus.co\/init-args\/advanced\/third-party-services\/","title":{"rendered":"Third-Party Services"},"content":{"rendered":"
\n

Global Services<\/h1>\n<\/div>\n
Typically you can register a global service<\/a> simply by adding the [Service] attribute<\/a> directly to type of the service:<\/div>\n
\n
\n
\n
[Service]\r\npublic class SomeService { }<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
Sometimes, however, you might want to create services from types defined inside third-party assets, in which case making any modifications to their source code could be out of the question.<\/div>\n
<\/div>\n
You can get around this problem using a Service Initializer<\/a><\/strong>.<\/div>\n
Service Initializer<\/h2>\n
To register a global service without modifying the source code of the service, you can define a class which derives from a ServiceInitializer<TService...><\/code> base class and add the [Service] attribute to it instead:<\/div>\n
\n
\n
[Service(typeof(SomeService))]\r\nclass SomeServiceInitializer : ServiceInitializer<SomeService> { }<\/pre>\n<\/div>\n<\/div>\n
As usual, you can use all the properties that the [Service] attribute has to customize how Init(args) should create or locate the service during initialization.<\/div>\n
\n
\n
[Service(typeof(Cinemachine), SceneName = \"Services\")]\r\nclass CinemachineInitializer : ServiceInitializer<Cinemachine> { }<\/pre>\n<\/div>\n<\/div>\n
You can also override the InitTarget<\/code> method to provide custom code for resolving the instance.<\/div>\n
<\/div>\n
For example, if a third-party asset was using the Singleton pattern<\/a> to lazily instantiate the service when needed, you could implement InitTarget to acquire the instance via the singleton’s static accessor:<\/div>\n
\n
\n
[Service(typeof(SomeSingleton), LazyInit = true)]\r\nclass SomeSingletonInitializer : ServiceInitializer<SomeSingleton>\r\n{\r\n    public override SomeSingleton InitTarget() => SomeSingleton.Instance;\r\n}<\/pre>\n<\/div>\n<\/div>\n
If you need to access some other global services in order to initialize this global service, you can list the defining types<\/a> of those other services as generic type argument of the base class, and then you will automatically receive them as arguments of the InitTarget method:<\/div>\n
\n
\n
\n
[Service(typeof(SomeSingleton), LazyInit = true)]\r\nclass SomeSingletonInitializer : ServiceInitializer<SomeSingleton, SomeSingletonSettings>\r\n{\r\n    public override SomeSingleton InitTarget(SomeSingletonSettings settings)\r\n    {\r\n        var instance = SomeSingleton.Instance;\r\n        instance.Settings = settings;\r\n        return instance;\r\n    }\r\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
If you need to access some other objects which are not global services<\/strong> in order to initialize the global service, you can also make the service initializer derive from ScriptableObject or MonoBehaviour, and make it implement a IServiceInitializer<TService...><\/code> interface. You could then use serialized fields (including Any<TValue><\/a> fields for extended functionality) to assign any dependencies you need using the Inspector window, and use the properties of the [Service] attribute to tell Init(args) how it should locate the service initializer:<\/p>\n
\n
\n
\n
[CreateAssetMenu]\r\n[Service(typeof(SomeSingleton), ResourcePath = \"SomeSingletonInitializer\")]\r\nclass SomeSingletonInitializer : ScriptableObject, IServiceInitializer<SomeSingleton>\r\n{\r\n    [SerializeField] SomeSingletonSettings settings;\r\n    public override SomeSingleton InitTarget()\r\n    {\r\n        var instance = SomeSingleton.Instance;\r\n        instance.Settings = settings;\r\n        return instance;\r\n    }\r\n}<\/pre>\n<\/div>\n<\/div>\n<\/div>\n
\n
Service Initializer Async<\/h2>\n
If acquiring the third-party service might not complete immediately, you can also derive from ServiceInitializerAsync<TService...><\/code>:<\/p>\n<\/div>\n
\n
\n
[Service(typeof(SomeService), LoadAsync = true)]\r\nclass SomeServiceInitializer : ServiceInitializerAsync<SomeService>\r\n{\r\n    public override async Task<SomeService> InitTargetAsync()\r\n    {\r\n        var loadService = Resources.LoadAsync<GameObject>(\"SomeService\");\r\n        await loadService;\r\n        var service = ((GameObject)loadService.asset).GetComponent<SomeService>();\r\n\r\n        var loadDependency = Resources.LoadAsync<GameObject>(\"SomeDependency\");\r\n        await loadDependency;\r\n        service.Dependency = ((GameObject)loadDependency.asset).GetComponent<SomeDependency>();\r\n        return service;\r\n    }\r\n}<\/pre>\n<\/div>\n
Local Services<\/h1>\n
If you have a third-party object that you want to automatically pass to some clients, but they do not exist for the entirely lifetime of the application, then you can register them as local services<\/a> instead.<\/p>\n
Registering local services from third-party assets works exactly the same way as it does with types that you own: using a Service Tag<\/a> or a\u00a0Services component<\/a>.<\/p>\n
 <\/p>\n
If you need to register a plain old C# object as a local service, you can use a Wrapper<\/a>, and then attach the Service Tag to the Wrapper, or drag-and-drop the Wrapper into a Services component.<\/p>\n
If you need to register a local service from a third-party object that only becomes available at runtime, you can create a Value Provider<\/a> that locates the object, and drag-and-drop the Value Provider into a Services component.<\/p>\n
Manual<\/h1>\n<\/div>\n
If all else fails, you can also register third-party objects as global or local services manually in code using Service.Set<\/a> or Service.AddFor<\/a> respectively.<\/p>\n
One downside with this approach, though, is that then Init(args) won’t know anything about those services existing in Edit Mode. This means that:<\/p>\n
    \n
  1. The Null Argument Guard<\/a> can warn you about those services being missing, even if they are going to be available at runtime.<\/li>\n
  2. You won’t be able to use click-to-ping in the Inspector to easily locate these services via their clients.<\/li>\n
  3. These services won’t have a (Service)<\/code> label in their header in the Inspector in Edit Mode.<\/li>\n<\/ol>\n
    To resolve the first problem, you can attach an Initializer<\/a> to clients and select Wait For Service<\/strong> from the dropdown of those services.<\/p>\n
     <\/p>\n","protected":false},"excerpt":{"rendered":"
    Global Services Typically you can register a global service simply by adding the [Service] attribute directly to type of the service: [Service] public class SomeService { } Sometimes, however, you might want to create services from types defined inside third-party assets, in which case making any modifications to their source code could be out of ..<\/p>\n
    <\/div>\n
    Read more<\/a><\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":[],"categories":[1],"tags":[],"_links":{"self":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/1053"}],"collection":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/comments?post=1053"}],"version-history":[{"count":14,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/1053\/revisions"}],"predecessor-version":[{"id":1069,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/1053\/revisions\/1069"}],"wp:attachment":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/media?parent=1053"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/categories?post=1053"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/tags?post=1053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}