using IPQualityScore.UnitySDK;

using Newtonsoft.Json;

using System;

using UnityEngine;

​

/*

 * IPQS_Interface

 * 

 * A simple example for how to use the IPQualityScore.UnitySDK

 * 

 * SETUP:

 *    - Place your IPQS API key int the constant "API_KEY"

 *    - Place the IPQualityScore.UnitySDK.<Platform>.dll file 

 *          in the folder Assets/Plugins

 * 

 * DO NOT!!!

 *    Do not run ipqsUnitySDK.GetScore(OnCompletion) asynchronously.

 *          (marked below)

 *    Everything in the SDK that can run asynchronously is already

 *          set up to do so.

 *    There are a few important items that will crash if not 

 *          ran on the main thread.

 *    

 */

​

#nullable enable

​

public class IPQS_Interface

{

    /*

     * Parameters

     */

    // Your API Key

    private const string API_KEY = "<< YOUR KEY HERE >>";

​

    // The SDK object

    private static IPQSUnitySDK ipqsUnitySDK = new IPQSUnitySDK(API_KEY);

​

    // The IPQualityScore fraud score

    private static IPQSResults? ipqsResults;

​

​

    /*

     * Method for receiving a fraud score

     */

    public void GetScore() {

        try {

​

            /* 

             * Set custom fingerprint settings: Optional

             * default = false

             * parameter = bool: true obtains a better fraud score, 

             *      false otherwise.

             * return = bool indicating what the fingerprinter

             *      has been set to

             * 

             * WARNING!!! If FindUserLocation or CopyUserClipboard are

             *      true you must prompt the user BEFORE 

             *      calling GetScore().

             *      Otherwise that data will not be collected.

             */

            ipqsUnitySDK.FindUserLocation(false);

            ipqsUnitySDK.FindUserAdvertisingID(false);

            ipqsUnitySDK.CopyUserClipboard(false);

            ipqsUnitySDK.SetIsEnhancedScore(false);

​

            /*

             * Add all custom variables.

             *      Not necessary if not collecting additional data

             *      

             * These custom keys must be set up in your IPQualityScore 

             *      dashboard beforehand.

             * 

             * AddCustomVariable(<String> key, <String?> value)

             * 

             * return = bool.  true = the fingerprinter actually contains

             *      the given key and value.  false otherwise

             * An alternative way of doing this is given at the bottom

             *      of this class

             */

            ipqsUnitySDK.AddCustomVariable("Key #1", "Value #1");

            ipqsUnitySDK.AddCustomVariable("Key #2", "Value #2");

            ipqsUnitySDK.AddCustomVariable("Key #3", "Value #3");

            ipqsUnitySDK.AddCustomVariable("Key #4", "Value #4");

​

​

            /* 

             *  Customize HTTPS Timeout Length: OPTIONAL

             *      Default = 15 seconds

             *      Must be set before getting score to see effect

             *  

             *  SetHttpsTimeout(<int> length)

             *  Parameter = custom length of time in seconds

             *  return = true if time length setting was properly set,

             *      false otherwise

             */

            ipqsUnitySDK.SetHttpsTimeout(15);

​

​

            /*

             * Gets the device fingerprint and fraud score.

             * This MUST be executed on the main thread

             * Parameter: A callback method (illustrated below)

             */

            ipqsUnitySDK.GetScore(OnCompletion);

        }

        catch (Exception e) {

            /* 

             * This log will help diagnose any unexpected 

             * exceptions: please include

             */

            UnityEngine.Debug.Log("IPQualityScore.IPQS_Interface:GetScore: "

                                  + e.ToString());

        }

    }

​

​

​

    /*

     * Callback Method for GetScore(<callback method>)

     * 

     * This is ran once the SDK receives a fraud 

     *     score response.

     *      

     * Parameter results = a copy of the fraud score results

     *     as an IPQSResults object

     */

    private static void OnCompletion(IPQSResults results) {

        try {

            // record fraud score

            ipqsResults = results;

​

            /*

             * Run any methods necessary to your project that 

             * utilize the fraud score

             */

        }

        catch (Exception e) {

            /* 

             * This log will help diagnose any unexpected 

             * exceptions: please include

             */

            UnityEngine.Debug.Log("IPQualityScore.IPQS_Interface:OnCompletion: "

                                  + e.ToString());

        }

    }

​

​

​

    /*

     * Alternative way to add custom variables from elsewhere

     *      in the project.

     *

     * Return: 

     *      true if key/value pair successfully added

     *      false otherwise 

     *

     * NOT REQUIRED

     */

    public bool AddCustomVariable(String key, String? value) {

        return ipqsUnitySDK.AddCustomVariable(key, value);

    }

​

​

​

    /*

     * GetResults()

     * 

     * A simple getter method for the fraud score after a

     *     successful API call.

     * 

     * return = IPQSResult?

     *     null if fraud score has not been obtained yet.

     *

     * NOT REQUIRED if using the fraud score results in the

     *     call back method above, onCompletion(<IPQSResults>).

     */

    public static IPQSResults? GetIPQSResults() {

        return ipqsResults;

    }

​

}