LivingSim pour Unity · politique

Soutien, compatibilité et stabilité

Ce que vous obtenez, ce qui reste identique d'une version à l'autre, ce que nous prenons en charge et comment nous joindre. Cette page est un miroir tenu à jour de la politique qui figure dans le dépôt de LivingSim, où un test veille à ce qu'elle reste cohérente avec le README du paquet, la fiche de la boutique et les notes d'empaquetage.

Ce qui est livré, et ce qui est fourni en code source

  • Le code source du moteur est fermé. LivingSim.Core.dll, LivingSim.Sdk.dll, LivingSim.Inspection.dll et LivingSim.UnityAdapter.dll sont livrés sous forme d'assemblys .NET Standard 2.1 compilés. Si disposer du code source du moteur est essentiel à votre projet, ce paquet ne vous convient pas, et nous préférons le dire ici plutôt qu'après un achat.
  • Tout ce qui touche votre projet est du C# lisible. Les composants Unity (Runtime/), le jeu d'exemple et sa scène (Samples/), ainsi que le HouseShareGame qu'exécute l'exemple, sont du code source simple que vous pouvez lire, modifier et copier.
  • Chaque assembly est accompagné de sa documentation et de ses symboles. LivingSim.*.xml donne à votre IDE une infobulle pour chaque membre documenté ; LivingSim.*.pdb fournit le fichier et la ligne de toute trace de pile qui passe par le moteur. Conservez-les à côté des DLL.
  • Aucun réseau, aucune télémétrie, aucun modèle. Le moteur est déterministe et fonctionne hors ligne. Rien dans le paquet n'effectue d'appel vers l'extérieur.

La documentation de référence de l’API LivingSim n’est offerte qu’en anglais.

Versions : ce qui constitue un changement incompatible

Le paquet suit la gestion sémantique de version (Semantic Versioning). La version figure dans VERSION.txt, dans les propriétés de fichier de chaque DLL et en haut de CHANGELOG.md. Les règles ci-dessous sont celles qu'énoncent la politique de surface d'API et les notes d'empaquetage du dépôt ; un test veille à ce que les trois disent la même chose.

  • Ce qui est pris en charge. La surface prise en charge comprend la façade LivingSimSdk et l'API documentée du moteur, LivingSim.Core. La façade, c'est LivingSimSdk, ses sept domaines (Characters, Places, Items, Actions, Relationships, Time, Events), Save et Load, ainsi que les vues copiées qu'ils renvoient ; l'API documentée du moteur, c'est SimulationEngine (construction, avancement pas à pas, enregistrement, requêtes, instantanés), WorldEvent et son vocabulaire, le chargeur de scénarios et les types d'état durable que documente la référence. Les vues d'inspection et l'adaptateur hôte (LivingSim.Inspection, LivingSim.UnityAdapter) sont des outils facultatifs destinés à l'inspecteur de débogage et peuvent évoluer avec lui. Tout le reste de ce qui se trouve être public dans les DLL relève du substrat du moteur, et non d'un engagement.
  • Tant que la version commence par 0 (0.x) : une version mineure peut modifier la surface prise en charge ou le format de sauvegarde, et chaque changement de ce type figure sous Changed dans le journal des modifications, avec la marche à suivre. Une version corrective (de 0.1.0 à 0.1.1) ne modifie aucune signature prise en charge et charge toutes les sauvegardes que la version mineure peut charger.
  • À partir de 1.0 : un changement incompatible de la surface prise en charge ou de ce qu'accepte Load fait passer à la version majeure suivante. Une version mineure ajoute ; une version corrective corrige. Tout ce qui est marqué [Obsolete] continue de fonctionner pendant au moins une version mineure avant de pouvoir être retiré, et n'est pas retiré avant la prochaine version majeure.
  • Sauvegardes. Une sauvegarde créée avec une version se charge dans toutes les versions correctives ultérieures de la même version mineure. D'une version mineure à l'autre en 0.x, ou d'une version majeure à l'autre à partir de 1.0, le journal des modifications indique si les anciennes sauvegardes se chargent, et une sauvegarde qui ne peut pas être chargée échoue à Load avec un message, plutôt que de se charger incorrectement.
  • Déterminisme. La même graine et les mêmes appels donnent le même résultat, et une sauvegarde chargée se poursuit comme l'original l'aurait fait, au sein d'une même version. Une nouvelle version peut changer ce que font les personnages (c'est à cela que sert la plupart des versions) : un rejeu enregistré sur une version ne constitue donc pas un test de la suivante.

Versions de Unity et environnements d'exécution pris en charge

  • Vérifié : Unity 2022.3 LTS (2022.3.62f1) et Unity 6 (6000.4.5f1 et 6000.6.4f1) dans l'éditeur sous Mono, y compris avec Reload Domain désactivé ; et Unity 2022.3.62f1 dans un lecteur autonome IL2CPP, avec l'élagage du code managé aux niveaux « Low » et « High », sans link.xml.
  • Devrait fonctionner, mais pas encore vérifié : les autres versions de Unity 2022.3 et de Unity 6, ainsi qu'IL2CPP sur Unity 6. Le paquet n'utilise aucune API propre à une version et cible .NET Standard 2.1 avec l'une ou l'autre valeur de Api Compatibility Level.
  • Non pris en charge : les versions de Unity antérieures à 2022.3, ainsi que les lecteurs WebGL et pour consoles tant que nous ne les avons pas vérifiés (une version WebGL de l'exemple est prévue ; quand elle sera publiée, cette page l'indiquera).

Chaque version publiée est vérifiée de nouveau sur les versions qu'elle mentionne ; la section Requirements du README du paquet et la fiche de la boutique mentionnent les mêmes versions que cette page.

Soutien

  • Où : par courriel à [email protected], ou sur la page d'éditeur de l'Asset Store. Veuillez indiquer la version du paquet (VERSION.txt), la version de Unity et le backend et, si possible, une sauvegarde ou une graine qui reproduit le problème.
  • Délai de réponse visé : dans la mesure du possible, normalement dans un délai de trois jours ouvrables. Un bogue reproductible dans une configuration prise en charge est corrigé dans la prochaine version corrective lorsque c'est faisable ; un correctif qui nécessite une nouvelle API attend une version mineure.
  • Les mises à jour sont gratuites pour les acheteurs de la fiche ; la version et le journal des modifications sont fournis dans le paquet.

Ce que nous ne promettons pas

  • L'accès au code source du moteur, ou une licence pour celui-ci.
  • La compatibilité avec les versions de Unity antérieures à 2022.3, ou avec les plateformes qui ne sont pas mentionnées ci-dessus.
  • Qu'une version ultérieure conserve à l'identique le comportement de chaque personnage. Les correctifs et une meilleure modélisation changent les résultats ; le journal des modifications nomme les mécanismes qui ont changé.