# Capacitor Axa Mobile Sdk

**Axa Mobile Sdk** is a modern, well-supported, and cross-platform sdk for App Experience Analytics that provides deep insights into the performance, user experience, crash, and log analytics of apps. This plugin, helps applications using Capacitor as the Native bridge to collect and fine tune custome metrics.

## Versioning
- Capacitor 7 support starts from 25.2.2 release
- Capacitor 6 support starts from 24.7.2 release
- Use previous versions for below Capacitor 6

## Platforms Supported

-  iOS
-  Android

## Getting started

[DX App Experience Analytics](https://www.broadcom.com/info/aiops/app-analytics)

Check out our [documentation](https://techdocs.broadcom.com/content/broadcom/techdocs/us/en/ca-enterprise-software/it-operations-management/app-experience-analytics-saas/SaaS/reference/data-collected-by-ca-app-experience-analytics-sdk.html) for more information about the features that the App Experience Analytics SDK collects from your app.

## Prerequisite(For iOS only)

Run the following command to install the **Ruby Gem xcodeproj** to make the **CAMDOReporter.h** file as a public header of the AXA Capacitor plugin target in your application:
```bash 
sudo gem install xcodeproj
```

## Register Your Application

Register your application with AXA. For more information, see the [Manage Apps](https://techdocs-author.broadcom.com/us/en/ca-enterprise-software/it-operations-management/app-experience-analytics-saas/SaaS/using/manage-apps.html) section.

## Integrate SDK

-  Download the **camdo.plist** file.

    1. Click **MANAGE APPS** in the DX App Experience Analytics Administration Console.
    2. Select the application you want to wrap and then under **HYBRID** , click **Capacitor**.
    3. Download the **<appname>_camdo.plist** file.

- Install Plugin
    ```bash
    npm install capacitor-axa-mobile-sdk-plugin
    npx cap sync
    ```
    >**Note:** Goto **ios/App** folder and Run **pod update 'CAMobileAppAnalytics'** to get the latest version of pod.

- Set up your platform

    <blockquote>
    <details>
    <summary> iOS </summary>

    - Integrate SDK
        1. Go to the ios/App folder and open the workspace
        2. Drag and drop the downloaded xxx_camdo.plist file into the project target.
        3. Add the following code in the App Component class to subscribe to the Ionic router change event:
        ```bash
        import { NavigationEnd, Router } from '@angular/router';
        import { CapacitorAxaMobileSdk } from 'capacitor-axa-mobile-sdk-plugin';

        export class AppComponent {
            constructor(private router: Router) {
                this.router.events.subscribe((e) => {
                    if (e instanceof NavigationEnd) {
                        setTimeout(() => {
                        CapacitorAxaMobileSdk.viewLoaded({viewName:
                            e.urlAfterRedirects, loadTime: 0.25, screenShot: true}).then((result) => {    
                        });
                        }, 250);
                    }
                });
            }
        }
        ```

    - Initialising the SDK in your Source code

    <blockquote>
    <details>
    <summary> Swift </summary>
        
        1. Add a header file with the file name format as `<app_name>-Bridging-header.h`.  
        
        2. Add the import header `#import "CAMDOReporter.h"` to your `<app_name>-Bridging-header.h` file. 

        3. Add the `<app_name>-Bridging-header.h` file to Swift Compiler - Code Generation section in the Build Settings.
            `<name of the project>/<app_name>-Bridging-header.h`
            
        4. Initialize the CAMobileAppAnalytics sdk in `didFinishLaunchingWithOptions` method
        ```sh
        func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
            //Initialize CA App Experience Analytics SDK
            CAMDOReporter.initializeSDK(options: SDKOptions.SDKLogLevelVerbose) { (completed, error) in

            }
            return true
        }
        ```
    
        5. Drag & Drop the downloaded `xxx_camdo.plist` file into the Supporting files
    </details>
    </blockquote>

    <blockquote>    
    <details>
    <summary> Objective C </summary>
        
        1. Add the import header `#import "CAMDOReporter.h"` to your AppDelegate.m file
        
        2. Initialize the CAMobileAppAnalytics sdk in `didFinishLaunchingWithOptions:` method 
        
        ```sh
            - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
            {
                [CAMDOReporter initializeSDKWithOptions:SDKLogLevelVerbose  completionHandler:nil];
                return YES;
            }
        ```
        3. Drag & Drop the downloaded `xxx_camdo.plist` file into the Supporting files
    
    </details>
    </blockquote>

    </details>
    </blockquote>

    <blockquote>
    <details>
    <summary> Android </summary>

        1. Go to the android folder and add packages.broadcom.com as a repository in the project build.gradle file
        ```bash
            buildscript {
                repositories {
                    google()
                    ..
                    ..
                    maven {
                        url 'https://packages.broadcom.com/apm-agents'
                    }
                }
                dependencies {
                    .. 
                    .. 
                    classpath 'com.ca.dxapm:sdk-gradle-plugin:2022.6.0.0'
                }
            }

            allprojects {
                repositories {
                    google()
                    ..
                    ..
                    maven {
                        url 'https://packages.broadcom.com/apm-agents'
                    }
                }
            }
        ```

        2. Go to the android/app folder and add the following to the app's build.gradle file:
        ```bash
        apply plugin: 'com.ca.dxapm.sdk.gradle.plugin'
        cadxapmsdk {
            plist = "path to camdo.plist"
        }
        ```
        
    </blockquote>
    </details>


## Updation

```bash
npm upgrade capacitor-axa-mobile-sdk-plugin
npx cap sync
```
>**Note:** Goto **ios/App** folder and Run **pod update 'CAMobileAppAnalytics'** to get the latest version of pod.


## Usage

```typescript
import { CAMDOSDKImageQualityType, CapacitorAxaMobileSdk } from 'capacitor-axa-mobile-sdk-plugin';

CapacitorAxaMobileSdk.addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED, () => {
  console.log("Upload initiated by SDK");
})

CapacitorAxaMobileSdk.getDeviceId().then(({value}) => {
    console.log(value);
});
```
## APIs

Individual APIs interact with the SDK to perform specific tasks, reading, or setting information.  All APIs are asynchronous and returning information is achieved using a block.


```typescript
CapacitorAxaMobileSdk.individualAPI();
CapacitorAxaMobileSdk.individualAPI({ argument1: value, argument2: value, ... });
CapacitorAxaMobileSdk.individualAPI({ argument1: value, argument2: value, ... }).then(result) => {};
```


<docgen-index>

* [`enableSDK()`](#enablesdk)
* [`disableSDK()`](#disablesdk)
* [`isSDKEnabled()`](#issdkenabled)
* [`getDeviceId()`](#getdeviceid)
* [`getCustomerId()`](#getcustomerid)
* [`setCustomerId(...)`](#setcustomerid)
* [`setSessionAttribute(...)`](#setsessionattribute)
* [`enterPrivateZone()`](#enterprivatezone)
* [`exitPrivateZone()`](#exitprivatezone)
* [`isInPrivateZone()`](#isinprivatezone)
* [`getAPMHeaders()`](#getapmheaders)
* [`addToAPMHeader(...)`](#addtoapmheader)
* [`setSSLPinningMode(...)`](#setsslpinningmode)
* [`stopCurrentSession()`](#stopcurrentsession)
* [`startNewSession()`](#startnewsession)
* [`stopCurrentAndStartNewSession()`](#stopcurrentandstartnewsession)
* [`startApplicationTransaction(...)`](#startapplicationtransaction)
* [`stopApplicationTransaction(...)`](#stopapplicationtransaction)
* [`setCustomerFeedback(...)`](#setcustomerfeedback)
* [`setCustomerLocation(...)`](#setcustomerlocation)
* [`sendScreenShot(...)`](#sendscreenshot)
* [`viewLoaded(...)`](#viewloaded)
* [`ignoreView(...)`](#ignoreview)
* [`ignoreViews(...)`](#ignoreviews)
* [`isScreenshotPolicyEnabled()`](#isscreenshotpolicyenabled)
* [`logNetworkEvent(...)`](#lognetworkevent)
* [`logTextMetric(...)`](#logtextmetric)
* [`logNumericMetric(...)`](#lognumericmetric)
* [`uploadEvents()`](#uploadevents)
* [`addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_CRASH_OCCURRED, ...)`](#addlistenercamaa_notification_typecamaa_crash_occurred-)
* [`addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED, ...)`](#addlistenercamaa_notification_typecamaa_upload_initiated-)
* [`logUIEvent(...)`](#loguievent)
* [`setNSURLSessionDelegate(...)`](#setnsurlsessiondelegate)
* [`setLocation(...)`](#setlocation)
* [`enableScreenShots(...)`](#enablescreenshots)
* [`induceNativeCrash(...)`](#inducenativecrash)
* [Interfaces](#interfaces)
* [Enums](#enums)

</docgen-index>

<docgen-api>
<!--Update the source file JSDoc comments and rerun docgen to update the docs below-->

### enableSDK()

```typescript
enableSDK() => Promise<void>
```

Use this API to enable SDK.
The SDK is enabled by default. You need to call this API
only if you called disableSDK earlier.

--------------------


### disableSDK()

```typescript
disableSDK() => Promise<void>
```

Use this API to disable the SDK.
When disabled, the SDK no longer does any tracking of the application,
or user interaction.

--------------------


### isSDKEnabled()

```typescript
isSDKEnabled() => Promise<{ value: boolean; }>
```

Use this API to determine if the SDK is enabled or not.

Returns a boolean value

**Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>

--------------------


### getDeviceId()

```typescript
getDeviceId() => Promise<{ value: string; }>
```

Use this API to get the unique device ID generated by the SDK

Returns a device id value

**Returns:** <code>Promise&lt;{ value: string; }&gt;</code>

--------------------


### getCustomerId()

```typescript
getCustomerId() => Promise<{ value: string | null; }>
```

Use this API to get the customer ID for this session.
Returns a customerId value. If the customer ID is not set, this API returns a null value.

**Returns:** <code>Promise&lt;{ value: string | null; }&gt;</code>

--------------------


### setCustomerId(...)

```typescript
setCustomerId(options: { customerId: string; }) => Promise<{ error: SDKError; }>
```

Use this API to set the customer ID for this session.

| Param         | Type                                 |
| ------------- | ------------------------------------ |
| **`options`** | <code>{ customerId: string; }</code> |

**Returns:** <code>Promise&lt;{ error: <a href="#sdkerror">SDKError</a>; }&gt;</code>

--------------------


### setSessionAttribute(...)

```typescript
setSessionAttribute(options: { name: string; value: string; }) => Promise<{ error: SDKError; }>
```

Use this API to set a custom session attribute.

| Param         | Type                                          |
| ------------- | --------------------------------------------- |
| **`options`** | <code>{ name: string; value: string; }</code> |

**Returns:** <code>Promise&lt;{ error: <a href="#sdkerror">SDKError</a>; }&gt;</code>

--------------------


### enterPrivateZone()

```typescript
enterPrivateZone() => Promise<void>
```

Use this API to stop collecting potentially sensitive data.

The following data is not collected when the app enters a private zone
   - Screenshots
   - Location information including GPS and IP addresses
   - Value in the text entry fields

--------------------


### exitPrivateZone()

```typescript
exitPrivateZone() => Promise<void>
```

Use this API to start collecting all data again

--------------------


### isInPrivateZone()

```typescript
isInPrivateZone() => Promise<{ value: boolean; }>
```

Use this API to determine if the SDK is in a private zone.

Returns a boolean value

**Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>

--------------------


### getAPMHeaders()

```typescript
getAPMHeaders() => Promise<{ value: object | null; }>
```

Use this API to get the SDK computed APM header in key value format.
Returns dictionary or map of key, value pairs
Returns an empty string if apm header cannot be computed

**Returns:** <code>Promise&lt;{ value: object | null; }&gt;</code>

--------------------


### addToAPMHeader(...)

```typescript
addToAPMHeader(options: { data: string; }) => Promise<void>
```

Use this API to add custom data to the SDK computed APM header.

| Param         | Type                           |
| ------------- | ------------------------------ |
| **`options`** | <code>{ data: string; }</code> |

--------------------


### setSSLPinningMode(...)

```typescript
setSSLPinningMode(options: { pinningMode: CAMDOSSLPinningMode; pinnedValues: string[]; }) => Promise<void>
```

Use this API to set the ssl pinning mode and array of pinned values.
This method expects array of values depending on the pinningMode

| Param         | Type                                                                                                          |
| ------------- | ------------------------------------------------------------------------------------------------------------- |
| **`options`** | <code>{ pinningMode: <a href="#camdosslpinningmode">CAMDOSSLPinningMode</a>; pinnedValues: string[]; }</code> |

--------------------


### stopCurrentSession()

```typescript
stopCurrentSession() => Promise<void>
```

Use this API to stop the current session.
No data will be logged until the startSession API is called

--------------------


### startNewSession()

```typescript
startNewSession() => Promise<void>
```

Use this API to start a new session.
If a session is already in progress, it will be stopped and new session is started

--------------------


### stopCurrentAndStartNewSession()

```typescript
stopCurrentAndStartNewSession() => Promise<void>
```

Convenience API to stop the current session in progress and start a new session
Equivalent to calling stopCurrentSession() and startNewSession()

--------------------


### startApplicationTransaction(...)

```typescript
startApplicationTransaction(options: { transactionName: string; serviceName?: string; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to start a transaction with a specific name

| Param         | Type                                                            |
| ------------- | --------------------------------------------------------------- |
| **`options`** | <code>{ transactionName: string; serviceName?: string; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### stopApplicationTransaction(...)

```typescript
stopApplicationTransaction(options: { transactionName: string; failure?: string; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to stop a transaction with a specific name and an optional failure string

| Param         | Type                                                        |
| ------------- | ----------------------------------------------------------- |
| **`options`** | <code>{ transactionName: string; failure?: string; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### setCustomerFeedback(...)

```typescript
setCustomerFeedback(options: { feedback: string; }) => Promise<void>
```

Use this API to provide feedback from the user after a crash

| Param         | Type                               |
| ------------- | ---------------------------------- |
| **`options`** | <code>{ feedback: string; }</code> |

--------------------


### setCustomerLocation(...)

```typescript
setCustomerLocation(options: { postalCode: string; countryCode: string; }) => Promise<void>
```

Use this API to set Location of the Customer/User
using postalCode and countryCode.

| Param         | Type                                                      |
| ------------- | --------------------------------------------------------- |
| **`options`** | <code>{ postalCode: string; countryCode: string; }</code> |

--------------------


### sendScreenShot(...)

```typescript
sendScreenShot(options: { name: string; quality: CAMDOSDKImageQualityType; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to send a screen shot of the current screen

| Param         | Type                                                                                                      |
| ------------- | --------------------------------------------------------------------------------------------------------- |
| **`options`** | <code>{ name: string; quality: <a href="#camdosdkimagequalitytype">CAMDOSDKImageQualityType</a>; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### viewLoaded(...)

```typescript
viewLoaded(options: { viewName: string; loadTime: number; screenShot?: boolean; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to create a custom app flow with dynamic views

| Param         | Type                                                                       |
| ------------- | -------------------------------------------------------------------------- |
| **`options`** | <code>{ viewName: string; loadTime: number; screenShot?: boolean; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### ignoreView(...)

```typescript
ignoreView(options: { viewName: string; }) => Promise<void>
```

Use this API to set the name of a view to be ignored

| Param         | Type                               |
| ------------- | ---------------------------------- |
| **`options`** | <code>{ viewName: string; }</code> |

--------------------


### ignoreViews(...)

```typescript
ignoreViews(options: { viewNames: string[]; }) => Promise<void>
```

Use this API to provide a list of view names to be ignored.

| Param         | Type                                  |
| ------------- | ------------------------------------- |
| **`options`** | <code>{ viewNames: string[]; }</code> |

--------------------


### isScreenshotPolicyEnabled()

```typescript
isScreenshotPolicyEnabled() => Promise<{ value: boolean; }>
```

Use this API to determine if automatic screenshots are enabled by policy.

Returns a boolean value
Returns YES if screenshots are enabled by policy.  Otherwise returns NO

**Returns:** <code>Promise&lt;{ value: boolean; }&gt;</code>

--------------------


### logNetworkEvent(...)

```typescript
logNetworkEvent(options: { url: string; status: number; responseTime: number; inBytes: number; outBytes: number; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to add a custom network event in the current session

| Param         | Type                                                                                                   |
| ------------- | ------------------------------------------------------------------------------------------------------ |
| **`options`** | <code>{ url: string; status: number; responseTime: number; inBytes: number; outBytes: number; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### logTextMetric(...)

```typescript
logTextMetric(options: { textMetricName: string; value: string; attributes?: object; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to add a custom text metric in the current session

| Param         | Type                                                                         |
| ------------- | ---------------------------------------------------------------------------- |
| **`options`** | <code>{ textMetricName: string; value: string; attributes?: object; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### logNumericMetric(...)

```typescript
logNumericMetric(options: { numericMetricName: string; value: number; attributes?: object; }) => Promise<{ completed: boolean; error: string | null; }>
```

Use this API to add a custom numeric metric value in the current session

| Param         | Type                                                                            |
| ------------- | ------------------------------------------------------------------------------- |
| **`options`** | <code>{ numericMetricName: string; value: number; attributes?: object; }</code> |

**Returns:** <code>Promise&lt;{ completed: boolean; error: string | null; }&gt;</code>

--------------------


### uploadEvents()

```typescript
uploadEvents() => Promise<{ response: object; error: string | null; }>
```

Use this API to force an upload event.
This is bulk/resource consuming operation and should be used with caution

**Returns:** <code>Promise&lt;{ response: object; error: string | null; }&gt;</code>

--------------------


### addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_CRASH_OCCURRED, ...)

```typescript
addListener(eventName: CAMAA_NOTIFICATION_TYPE.CAMAA_CRASH_OCCURRED, listenerFunc: () => void) => Promise<PluginListenerHandle> & PluginListenerHandle
```

| Param              | Type                                                                                             |
| ------------------ | ------------------------------------------------------------------------------------------------ |
| **`eventName`**    | <code><a href="#camaa_notification_type">CAMAA_NOTIFICATION_TYPE.CAMAA_CRASH_OCCURRED</a></code> |
| **`listenerFunc`** | <code>() =&gt; void</code>                                                                       |

**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt; & <a href="#pluginlistenerhandle">PluginListenerHandle</a></code>

--------------------


### addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED, ...)

```typescript
addListener(eventName: CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED, listenerFunc: () => void) => Promise<PluginListenerHandle> & PluginListenerHandle
```

| Param              | Type                                                                                               |
| ------------------ | -------------------------------------------------------------------------------------------------- |
| **`eventName`**    | <code><a href="#camaa_notification_type">CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED</a></code> |
| **`listenerFunc`** | <code>() =&gt; void</code>                                                                         |

**Returns:** <code>Promise&lt;<a href="#pluginlistenerhandle">PluginListenerHandle</a>&gt; & <a href="#pluginlistenerhandle">PluginListenerHandle</a></code>

--------------------


### logUIEvent(...)

```typescript
logUIEvent(options: { eventType: CAMDOUIEventType; value: string; }) => Promise<void>
```

| Param         | Type                                                                                         |
| ------------- | -------------------------------------------------------------------------------------------- |
| **`options`** | <code>{ eventType: <a href="#camdouieventtype">CAMDOUIEventType</a>; value: string; }</code> |

--------------------


### setNSURLSessionDelegate(...)

```typescript
setNSURLSessionDelegate(options: { delegate: string; }) => Promise<void>
```

Use this API to set your delegate instance to handle auth challenges.
Use it when using SDKUseNetworkProtocolSwizzling option

| Param         | Type                               |
| ------------- | ---------------------------------- |
| **`options`** | <code>{ delegate: string; }</code> |

--------------------


### setLocation(...)

```typescript
setLocation(options: { latitude: number; longitude: number; }) => Promise<void>
```

Use this API to set Geographic or GPS Location of the Customer

| Param         | Type                                                  |
| ------------- | ----------------------------------------------------- |
| **`options`** | <code>{ latitude: number; longitude: number; }</code> |

--------------------


### enableScreenShots(...)

```typescript
enableScreenShots(captureScreen: boolean) => Promise<void>
```

Use this API to programmatically enable or disable automatic screen captures.

| Param               | Type                 | Description                                                                                                                                                                                                               |
| ------------------- | -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **`captureScreen`** | <code>boolean</code> | is a boolean value to enable/disable automatic screen captures. Normally the policy determines whether automatic screen captures are performed. Use this API to override the policy, or the current setting of this flag. |

--------------------


### induceNativeCrash(...)

```typescript
induceNativeCrash(options: { crashType: string; }) => void
```

This is a SDK Dev API

| Param         | Type                                |
| ------------- | ----------------------------------- |
| **`options`** | <code>{ crashType: string; }</code> |

--------------------


### Interfaces


#### PluginListenerHandle

| Prop         | Type                                      |
| ------------ | ----------------------------------------- |
| **`remove`** | <code>() =&gt; Promise&lt;void&gt;</code> |


### Enums


#### SDKError

| Members                           |
| --------------------------------- |
| **`ErrorNone`**                   |
| **`ErrorNoTransactionName`**      |
| **`ErrorTransactionInProgress`**  |
| **`ErrorFailedToTakeScreenshot`** |
| **`ErrorInvalidValuesPassed`**    |


#### CAMDOSSLPinningMode

| Members                                           |
| ------------------------------------------------- |
| **`CAMDOSSLPinningModeNone`**                     |
| **`CAMDOSSLPinningModePublicKey`**                |
| **`CAMDOSSLPinningModeCertificate`**              |
| **`CAMDOSSLPinningModeFingerPrintSHA1Signature`** |
| **`CAMDOSSLPinningModePublicKeyHash`**            |


#### CAMDOSDKImageQualityType

| Members                                | Value                                           |
| -------------------------------------- | ----------------------------------------------- |
| **`CAMAA_SCREENSHOT_QUALITY_HIGH`**    | <code>'CAMAA_SCREENSHOT_QUALITY_HIGH'</code>    |
| **`CAMAA_SCREENSHOT_QUALITY_MEDIUM`**  | <code>'CAMAA_SCREENSHOT_QUALITY_MEDIUM'</code>  |
| **`CAMAA_SCREENSHOT_QUALITY_LOW`**     | <code>'CAMAA_SCREENSHOT_QUALITY_LOW'</code>     |
| **`CAMAA_SCREENSHOT_QUALITY_DEFAULT`** | <code>'CAMAA_SCREENSHOT_QUALITY_DEFAULT'</code> |


#### CAMAA_NOTIFICATION_TYPE

| Members                      | Value                                 |
| ---------------------------- | ------------------------------------- |
| **`CAMAA_UPLOAD_INITIATED`** | <code>'CAMAA_UPLOAD_INITIATED'</code> |
| **`CAMAA_CRASH_OCCURRED`**   | <code>'CAMAA_CRASH_OCCURRED'</code>   |


#### CAMDOUIEventType

| Members                                     | Value                                  |
| ------------------------------------------- | -------------------------------------- |
| **`CAMAA_EVENT_BUTTON_PRESSED`**            | <code>'button_pressed'</code>          |
| **`CAMAA_AI_START`**                        | <code>'ai_start'</code>                |
| **`CAMAA_AI_END`**                          | <code>'ai_end'</code>                  |
| **`CAMAA_EVENT_DATE_PICKER_VIEW_SELECTED`** | <code>'date_picker_selected'</code>    |
| **`CAMAA_EVENT_PAGE_CHANGED`**              | <code>'page_changed'</code>            |
| **`CAMAA_EVENT_SEGMENTED_CONTROL_PRESSED`** | <code>'segment_control_pressed'</code> |
| **`CAMAA_EVENT_SLIDER_MOVED`**              | <code>'slider_moved'</code>            |
| **`CAMAA_EVENT_STEPPER_PRESSED`**           | <code>'stepper_pressed'</code>         |
| **`CAMAA_EVENT_SWITCH_PRESSED`**            | <code>'switch_pressed'</code>          |
| **`CAMAA_EVENT_RADIO_BUTTON_PRESS`**        | <code>"radio_button_pressed"</code>    |
| **`CAMAA_EVENT_CHECK_BOX_PRESS`**           | <code>"check_box_pressed"</code>       |
| **`CAMAA_EVENT_SPINNER_ITEM_SELECTED`**     | <code>"spinner_item_selected"</code>   |
| **`CAMAA_EVENT_TOGGLE_PRESS`**              | <code>"switch_pressed"</code>          |
| **`CAMAA_EVENT_UNSUPPORTED`**               | <code>"unknow_action"</code>           |

</docgen-api>

## iOS-only APIs
The iOS version of the SDK implements a few APIs which are not available in the Android version of the SDK.

The best way to handle these APIs is to put them in conditionals for the platform the App is running on
* [`addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_CRASH_OCCURRED, ...)`](#addlistenercamaa_notification_typecamaa_crash_occurred)
* [`addListener(CAMAA_NOTIFICATION_TYPE.CAMAA_UPLOAD_INITIATED, ...)`](#addlistenercamaa_notification_typecamaa_upload_initiated)
* [`logUIEvent(...)`](#loguievent)
* [`setNSURLSessionDelegate(...)`](#setnsurlsessiondelegate)
* [`setLocation(...)`](#setlocation)
* [`enableScreenShots(...)`](#enablescreenshots)