{"id":446,"date":"2024-10-22T08:00:07","date_gmt":"2024-10-22T08:00:07","guid":{"rendered":"https:\/\/docs.sisus.co\/init-args\/?p=446"},"modified":"2025-07-29T06:27:29","modified_gmt":"2025-07-29T06:27:29","slug":"global-services","status":"publish","type":"post","link":"https:\/\/docs.sisus.co\/init-args\/reference\/global-services\/","title":{"rendered":"Global Services"},"content":{"rendered":"

\"\"<\/p>\n

Services that can automatically be delivered to clients<\/a><\/strong> by Init(args) can be split into two groups based on their availability: global<\/strong> and local services<\/a><\/strong>.<\/p>\n

A global service is a service that is available to all clients, regardless of their location in the scene hierarchies.<\/p>\n

Registering Global Services<\/h2>\n

The main way to register global services is using\u00a0[Service] attribute<\/a><\/strong>.<\/p>\n

It’s also technically possible to create global services using any of the following methods:<\/p>\n

    \n
  1. Attach the Service Tag<\/a><\/strong> to a component in the first scene and set Availability<\/em> to Everywhere<\/em>.<\/li>\n
  2. Drag an Object into a Services component<\/a> <\/strong>in the first scene and set For Clients<\/em>\u00a0to Everywhere<\/em>.<\/li>\n
  3. Manually register an object as a service by calling Service.Set<\/a>\u00a0<\/strong>during the initialization of the application.<\/li>\n<\/ol>\n

    Registering Plain C# Objects<\/h2>\n

    Plain C# objects can be registered as global services using any the following methods:<\/p>\n

      \n
    1. By adding the [Service] attribute<\/strong> directly to its class.<\/li>\n
    2. By adding the [Service] attribute<\/strong> to a value provider<\/strong><\/a> class.<\/li>\n
    3. By attaching the Service Tag<\/strong> to a Wrapper<\/a><\/strong> that wraps the plain C# object and setting Availability<\/em> to Everywhere<\/em>.<\/li>\n
    4. By dragging a value provider<\/a><\/strong> that returns the plain C# object into a Services component<\/a><\/strong> and setting For Clients<\/em>\u00a0to Everywhere<\/em>.<\/li>\n
    5. By manually registering it as a service by calling Service.Set<\/a><\/strong><\/li>\n<\/ol>\n

      Best Practices<\/h2>\n

      Global services should typically exists for the entire lifetime of the application after being initialized. You always want to avoid situations where a client could live longer than one of the services that it depends on. Since all clients can receive global services, destroying or disposing global service after they have already been delivered to some clients is risky.<\/p>\n","protected":false},"excerpt":{"rendered":"

      Services that can automatically be delivered to clients by Init(args) can be split into two groups based on their availability: global and local services. A global service is a service that is available to all clients, regardless of their location in the scene hierarchies. Registering Global Services The main way to register global services is ..<\/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":[7],"tags":[],"_links":{"self":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/446"}],"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=446"}],"version-history":[{"count":15,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/446\/revisions"}],"predecessor-version":[{"id":992,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/posts\/446\/revisions\/992"}],"wp:attachment":[{"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/media?parent=446"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/categories?post=446"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/docs.sisus.co\/init-args\/wp-json\/wp\/v2\/tags?post=446"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}