Enables logging data asynchronously to a mobile application.
Allows an application to log data to a session, which will be sent to the associated phone application at the earliest convenience.
Create a new data logging session.
- Parameters
-
tag | A tag associated with the logging session. |
item_type | The type of data stored in this logging session |
item_length | The size of a single data item in bytes |
resume | True if we want to look for a logging session of the same tag and resume logging to it. If this is false and a session with the specified tag exists, that session will be closed and a new session will be opened. |
- Returns
- An opaque reference to the data logging session
void data_logging_finish |
( |
DataLoggingSessionRef |
logging_session | ) |
|
Delete a data logging_session. Logging data is kept until it has successfully been transferred over to the phone, but no data may be added to the session after this function is called.
- Parameters
-
logging_session | a reference to the data logging session previously allocated using data_logging_create |
Add data to the data logging session. If a phone is available, the data is sent directly to the phone. Otherwise, it is saved to the watch storage until the watch is connected to a phone.
- Parameters
-
logging_session | a reference to the data logging session you want to add the data to |
data | a pointer to the data buffer that contains multiple items |
num_items | the number of items to log. This means data must be at least (num_items * item_length) long in bytes |
- Returns
- DATA_LOGGING_SUCCESS on success DATA_LOGGING_NOT_FOUND if the logging session is invalid DATA_LOGGING_CLOSED if the sesion is not active DATA_LOGGING_BUSY if the sesion is not available for writing DATA_LOGGING_INVALID_PARAMS if num_items is 0 or data is NULL
The different types of session data we support. This type describes the type of a singular item in the data session. Every item in a given session is the same type and size.
Enumerator |
---|
DATA_LOGGING_BYTE_ARRAY |
Array of bytes. Remember that this is the type of a single item in the logging session, so using this type means you'll be logging multiple byte arrays (each a fixed length described by item_length) for the duration of the session.
|
DATA_LOGGING_UINT |
Unsigned integer. This may be a 1, 2, or 4 byte integer depending on the item_length parameter.
|
DATA_LOGGING_INT |
Signed integer. This may be a 1, 2, or 4 byte integer depending on the item_length parameter.
|
Enumerator |
---|
DATA_LOGGING_BUSY |
Someone else is writing to this logging session.
|
DATA_LOGGING_FULL |
No more space to save data.
|
DATA_LOGGING_NOT_FOUND |
The logging session does not exist.
|
DATA_LOGGING_CLOSED |
The logging session was made inactive.
|
DATA_LOGGING_INVALID_PARAMS |
An invalid parameter was passed to one of the functions.
|