NewObject

Inserts a new, empty, object into a database of objects.

Note: After adding a new object, you must add images of the object using the action AddObjectImages. You can also set training attributes using the action SetObjectTrainingOption. After adding images, train Media Server to recognize the object using the action BuildObject.

Note: This is an administrative action that can be sent only from AdminClients (which are set in the [Server] section of the configuration file).

Type: synchronous

Parameter Description Required
database The name of the database to add the object to. The database must already exist. Yes
identifier A unique identifier for the object (maximum 254 bytes). If you do not set this parameter, Media Server generates an identifier automatically. No

Example

The following example adds an object to the CompanyLogos database:

/action=NewObject&database=CompanyLogos

You can use the name of the object as the identifier. All identifiers must be unique within the database:

/action=NewObject&database=CompanyLogos&identifier=HewlettPackard

Response

The action returns the identifier assigned to the object:

<autnresponse>
  <action>NEWOBJECT</action>
  <response>SUCCESS</response>
  <responsedata>
    <identifier>6d8e53fd92e601a4b8948e1b9397e381</identifier>
  </responsedata>
</autnresponse>

See Also


_HP_HTML5_bannerTitle.htm