Click or drag to resize

ArticyDatabase Class

Access to all your imported articy data.
Inheritance Hierarchy
SystemObject
  Object
    ScriptableObject
      Articy.UnityArticyDatabase

Namespace:  Articy.Unity
Assembly:  ArticyRuntime (in ArticyRuntime.dll) Version: 1.0.3
Syntax
C#
public class ArticyDatabase : ScriptableObject, 
	ISerializationCallbackReceiver

The ArticyDatabase type exposes the following members.

Properties
  NameDescription
Public propertyStatic memberArticyDatabaseAssetFileName
Gets the name of the articy database asset file. Without extension
Public propertyStatic memberArticyDatabaseFolder
Gets the articy database folder. Ends with a /
Public propertyStatic memberArticyDatabasePath
Gets the articy database asset path. The whole path with the extension.
Public propertyStatic memberDefaultGlobalVariables
Gets the default variable storage used by all ArticyFlowPlayers when set to use the default one.
Public propertyStatic memberDefaultMethodProvider
When setting this property the plugin will use this IBaseScriptMethodProvider always when calling articy scripts manually without passing the IBaseScriptMethodProvider parameter.
Public propertyStatic memberInstance
Gets the instance of the articy database.
Public propertyStatic memberIsUnityPlaying
Gets a value indicating whether unity is currently in play mode.
Public propertyStatic memberLoadedPackages
Returns a list of all currently loaded packages.
Public propertyStatic memberLoadedPackagesCount
Returns the number of currently loaded packages.
Public propertyStatic memberLocalization
Gets the localization manager, allowing simple localization support.
Public propertyStatic memberObjectNotifications
Gets the object notifications, which can be used to set listeners on properties of articy objects.
Public propertyStatic memberObjects
Gets a readonly list of all Objects currently loaded in the database.
Public propertyStatic memberPackages
Gets a readonly list of all available packages.
Public propertyStatic memberProject
Gets the project information that were exported via articy draft.
Public propertyStatic memberProjectHierarchy
Gets the project hierarchy. A Manager containing all(even excluded or not exported) objects inside the used articy project in the form of lightweight information objects.
Public propertyStatic memberScriptFragments
Gets an internal used property to call script code from articy objects.
Top
Methods
  NameDescription
Public methodStatic memberClearDatabase
This will completely resets the database and remove all changes.
Public methodStatic memberCloneFrom(String, UInt32)
Creates a new clone of the object with the given technical name. The clone will get the supplied instance id. The clone must not exist beforehand.
Public methodStatic memberCloneFrom(UInt64, UInt32)
Creates a new clone of the object with the given object id. The clone will get the supplied instance id. The clone must not exist beforehand.
Public methodStatic memberCloneFromTObject(String, UInt32)
Creates a new clone of the object with the given technical name. The clone will get the supplied instance id. The clone must not exist beforehand.
Public methodStatic memberCloneOrGetFrom(String, UInt32)
Try to get the object with the given technical name and instance id, or clone it if the instance id wasn't found.
Public methodStatic memberCloneOrGetFrom(UInt64, UInt32)
Try to get the object with the given object id and instance id, or clone it if the instance id wasn't found.
Public methodStatic memberCloneOrGetFromTObject(String, UInt32)
Try to get the object with the given technical name and instance id, or clone it if the instance id wasn't found.
Public methodStatic memberCloneWithConsecutiveInstanceIdFrom(String, UInt32)
Creates a new clone from the object with the given technical name, and assigns automatically a new free consecutive instance id
Public methodStatic memberCloneWithConsecutiveInstanceIdFrom(UInt64, UInt32)
Creates a new clone from the object with the given object id, and assigns automatically a new free consecutive instance id
Public methodStatic memberCloneWithConsecutiveInstanceIdFromTObject(String, UInt32)
Creates a new clone from the object with the given technical name, and assigns automatically a new free consecutive instance id
Public methodStatic memberFilterObjects
Returns a list of all objects that match the given search string.
Public methodStatic memberFilterObjectsBasedOn
Returns a list of all objects that match the given search string based on a pre filtered list.
Public methodStatic memberGetAllOfTypeTObject
Gets all articy objects of the specified type.
Public methodStatic memberCode exampleGetObject(String)
Gets an object by its technical name. This is always the base object.
Public methodStatic memberCode exampleGetObject(String, UInt32)
Gets an object by its technical name and instance id.
Public methodStatic memberCode exampleGetObject(UInt64, UInt32)
Gets an object by its object id and an optional instance id.
Public methodStatic memberCode exampleGetObjectTObject(String)
Gets an object by its technical name and returning it in the specified type.
Public methodStatic memberCode exampleGetObjectTObject(String, UInt32)
Gets an object by its technical name and instance id and returning it in the specified type.
Public methodStatic memberCode exampleGetObjectTObject(UInt64, UInt32)
Gets an object by its object id and an optional instance id.
Public methodStatic memberGetObjects(String)
Gets all objects with the given technical name. This will contain all objects: base and clones.
Public methodStatic memberGetObjects(String, UInt32)
Gets all objects with the given technical name and instance id.
Public methodStatic memberIsDatabaseAvailable
Determines if the database is ready to be used.
Public methodStatic memberIsObjectAvailable(String)
Determines whether the object can be found in the database with the given technical name.
Public methodStatic memberIsObjectAvailable(UInt64)
Determines whether the object can be found in the database with the given object id.
Public methodStatic memberIsObjectInLoadedPackages
Determines whether the given object is in currently loaded packages.
Public methodStatic memberLoadPackage(String)
Loads the given package by name.
Public methodStatic memberLoadPackage(UInt64)
Loads the given package by id.
Public methodStatic memberRemoveAllClones(String)
Removes all clones for an object with the given id.
Public methodStatic memberRemoveAllClones(UInt64)
Removes all clones for an object with the given id.
Public methodStatic memberRemoveClone(String, UInt32)
Removes the clone with a given instance id from the object with the given technical name.
Public methodStatic memberRemoveClone(UInt64, UInt32)
Removes the clone with a given instance id from the object with the given object id.
Public methodStatic memberUnloadPackage(String, Boolean)
Unloads a previously loaded package.
Public methodStatic memberUnloadPackage(UInt64, Boolean)
Unloads a previously loaded package.
Top
Remarks

The database will be automatically be created when the plugin imports your articy draft data. Part of the plugin importer process is to automatically populate the database with your data. After the import is finished you can use the database and its static methods in the unity editor or at runtime to query, manage and filter your articy draft objects; manage your packages and get access to important parts for the flow execution, like the global variables.

Note Note
You don't have to create this class. An instance of this class is generated and populated while importing, and stored as an asset in the "Generated/Resources" folder in your Assets folder. You can just directly access all its properties directly.
Examples
C#
bool hasManfred = ArticyDatabase.IsObjectAvailable("Chr_Manfred");
See Also