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.
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
- If you haven't created a database for storing objects, first run the action CreateObjectDatabase.
- To add metadata about the object, use the action AddObjectMetadata.
- To add training images of the object, use the action AddObjectImages.
- To add training options that configure training for the object, use the action SetObjectTrainingOption.
- To train Media Server to recognize the object, use the action BuildObject.
- You can use the action TrainObject to add and train a new object, with metadata, training images, and training options, in a single action.