Setting Product Data
The setProductEdition:productLanguage:productVersion:productBuildNumber: function sets or clears the product data.
Note:The product data must be set every time the SDK instance is run.
Note:This is different than V4 of the Usage Intelligence (Trackerbird) SDK where the supplied product data was stored in the SDK configuration file and if it was not supplied, the values in the configuration file were used.
setProductEdition:productLanguage:productVersion:productBuildNumber: can be called between createConfig and stopSDK: and can be called zero or more times.
setProductEdition:productLanguage:productVersion:productBuildNumber: is a synchronous function returning when all functionality is completed.
setProductEdition:productLanguage:productVersion:productBuildNumber:
RUIRESULT ruiSetProductData(RUIINSTANCE* ruiInstance, const char* productEdition, const char* productLanguage, const char* productVersion, const char* productBuildNumber)
Parameters
The setProductEdition:productLanguage:productVersion:productBuildNumber: function has the following parameters.
|
Parameter |
Description |
|
productEdition (NSString*) |
The product edition that is to be set. Maximum length of 128 characters. |
|
productLanguage (NSString*) |
The product language that is to be set. Maximum length of 128 characters. |
|
productVersion (NSString*) |
The product version number that is to be set. Maximum length of 128 characters. |
|
productBuildNumber (NSString*) |
The product build number that is to be set. Maximum length of 128 characters. |
Returns
The setProductEdition:productLanguage:productVersion:productBuildNumber: function returns one of the return status constants below.
|
Return |
Description |
|
RUI_OK |
Function successful. |
|
RUI_SDK_INTERNAL_ERROR_FATAL |
Irrecoverable internal fatal error. No further API calls should be made. |
|
RUI_SDK_ABORTED |
A required New Registration has failed, and hence the SDK is aborted. stopSDK: and Objective-C instance release are possible. |
|
RUI_SDK_SUSPENDED |
The Server has instructed a temporary back-off. |
|
RUI_SDK_PERMANENTLY_DISABLED |
The Server has instructed a permanent disable. |
|
RUI_SDK_OPTED_OUT |
Instance has been instructed by the application to opt-out. |
|
RUI_CONFIG_NOT_CREATED |
Configuration has not been successfully created. |
|
RUI_SDK_ALREADY_STOPPED |
SDK has already been successfully stopped. |