add

fun <P : Pinglet> add(pinglet: P, sessionNumber: Int)

Adds a Pinglet to the analytics tracking queue.

This method serializes the provided Pinglet to JSON and attempts to add it to the native C++ tracking queue. The operation is thread-safe and can be called from multiple threads concurrently.

The method performs validation checks including:

  • JSON format validation

  • Size limit validation

  • License permission validation

If the Pinglet cannot be added due to validation failures, appropriate warnings are logged but no exceptions are thrown to maintain system stability.

Parameters

pinglet

The Pinglet to add to the tracking queue

sessionNumber

The session identifier for associating the Pinglet with a specific session

P

The specific Pinglet type extending the base Pinglet interface