Add PokiSDK.measure() (#24)

* Add PokiSDK.measure()

A new feature to track game events that will be released to all
developers soon.

* Add missing doc

Author: erikdubbelboer

docs/index.md

@@ -156,4 +156,5 @@ poki_sdk.set_debug(value) -- in JS it's PokiSDK.setDebug(value)
 poki_sdk.capture_error(error_string) -- in JS it's PokiSDK.captureError(error_string)
 poki_sdk.shareable_url(params, callback) -- in JS it's PokiSDK.shareableURL({}).then(url => {})
 local value = poki_sdk.get_url_param(key) -- in JS it's PokiSDK.getURLParam('id')
+poki_sdk.measure(category, what, action) -- in JS it's PokiSDK.measure(category, what, action)
 ```

poki-sdk/api/poki-sdk.script_api

@@ -91,6 +91,19 @@
     - name: value
       type: string
 
+#*****************************************************************************************************
+
+  - name: measure
+    type: function
+
+    parameters:
+    - name: category
+      type: string
+    - name: what
+      type: string
+    - name: action
+      type: string
+
 #*****************************************************************************************************
 
   - name: REWARDED_BREAK_ERROR

poki-sdk/lib/web/lib_pokisdk.js

@@ -97,7 +97,11 @@ var LibPokiSdk = {
         var key = UTF8ToString(key);
         var value = PokiSDK.getURLParam(key);
         return stringToUTF8OnStack(value);
-    }
+    },
+
+    PokiSdkJs_Measure: function(category, what, action) {
+        PokiSDK.measure(UTF8ToString(category), UTF8ToString(what), UTF8ToString(action));
+    },
 }
 
 autoAddDeps(LibPokiSdk, '$PokiSdk');

poki-sdk/src/pokisdk.cpp

@@ -40,6 +40,8 @@ extern "C" {
     void PokiSdkJs_AddParameterForURL(const char* key, const char* value);
     void PokiSdkJs_ShareableURL(ShareableURLCallback callback);
     const char* PokiSdkJs_GetURLParam(const char* key);
+
+    void PokiSdkJs_Measure(const char* category, const char* what, const char* action);
 }
 
 static dmScript::LuaCallbackInfo* pokiSdk_Callback = 0x0;
@@ -260,6 +262,18 @@ static int PokiSdk_GetURLParam(lua_State* L)
     return 1;
 }
 
+static int PokiSdk_Measure(lua_State* L)
+{
+    DM_LUA_STACK_CHECK(L, 0);
+    const char* category = luaL_checkstring(L, 1);
+    // what is optional and defaults to an empty string
+    const char* what = luaL_optstring(L, 2, "");
+    // action is optional and defaults to an empty string
+    const char* action = luaL_optstring(L, 3, "");
+    PokiSdkJs_Measure(category, what, action);
+    return 0;
+}
+
 // Functions exposed to Lua
 static const luaL_reg Module_methods[] =
 {
@@ -272,6 +286,7 @@ static const luaL_reg Module_methods[] =
     {"is_ad_blocked", PokiSdk_IsAdBlocked},
     {"shareable_url", PokiSdk_ShareableURL},
     {"get_url_param", PokiSdk_GetURLParam},
+    {"measure", PokiSdk_Measure},
     {0, 0}
 };