The criteria
object specifies what type
of device log entries are added to the event database and details about the
entry.
The criteria
object has two main properties: Type
and Item
.
These are described in the following table. Properties enclosed in brackets
are optional.
Property |
Description |
Type |
Value |
---|---|---|---|
|
Specifies the type of content. |
string |
Possible values:
|
|
Specifies the content of the entry to add to the event log. |
object |
Object with the properties specified below |
|
Specifies a unique identifier for the type of event. |
number |
Value - Description:
|
|
Specifies the destination of the outgoing event or the source of incoming event. |
string |
Up to 64 characters. If the length of the specified string is greater than 64 characters, the data is truncated. |
|
Specifies whether the event is incoming, outgoing, or missed and if it came in on an alternate line. Alternate line refers to the second phone call on the mobile device.
Alternate line values, such as |
number |
Value - Description:
|
|
Specifies the duration of the event, in seconds. |
number |
|
|
Specifies whether the event was delivered, is pending, failed to be delivered, and so on. |
number |
Value - Description:
|
|
Specifies the subject for the event. |
string |
Up to 64 characters. If the length of the specified string is greater than 64 characters, the data is truncated. |
|
Specifies the phone number associated with the event. This key is specified when the number cannot be stored in any other
key. For example, if there is an entry in the contacts database for a person
named Prakash, then |
string |
Up to 100 characters. If the length of the specified string is greater than 100 characters, the number is truncated. |
|
Specifies an ID (messageID, callID, or such) that links the event being added to an entity in another application. For example, it might be useful to link the event to an SMS messageID so that details of the message can be displayed to the mobile device user. |
number |
|
|
Specifies the flags for this event. This method does not change any of the other flag bit settings. |
number |
Possible values:
Note: The EKLogEventContactSearched flag is set when the user searches the contact database for any operation such as a voice call or SMS.
Note: The EKLogEventRead flag is set when the user "reads" the event in the log database. |