BLRInAppPurchase.h

Go to the documentation of this file.

#ifndef BLURRR_IN_APP_PURCHASE_H
#define BLURRR_IN_APP_PURCHASE_H


#if defined(__cplusplus)
extern "C" {
#endif


#ifndef DOXYGEN_SHOULD_IGNORE_THIS

        /* Note: For Doxygen to produce clean output, you should set the 
         * PREDEFINED option to remove DECLSPEC, CALLCONVENTION, and
         * the DOXYGEN_SHOULD_IGNORE_THIS blocks.
         * PREDEFINED = DOXYGEN_SHOULD_IGNORE_THIS=1 DECLSPEC= CALLCONVENTION=
         */
        
    #ifdef BIAP_BUILD_LIBRARY
        #ifdef WIN32
                #define BIAP_EXPORT __declspec(dllexport)
        #elif defined(__GNUC__) && __GNUC__ >= 4
                #define BIAP_EXPORT __attribute__ ((visibility("default")))
        #else
                #define BIAP_EXPORT
        #endif
    #else
        #define BIAP_EXPORT
    #endif /* BIAP_BUILD_LIBRARY */

    /*
        Nullability qualifiers: currently only supported by Clang.
     */
    #if defined(__clang__)
        #if __has_feature(nullability)
            #define BIAP_NONNULL _Nonnull
            #define BIAP_NULLABLE _Nullable
        #else
            #define BIAP_NONNULL
            #define BIAP_NULLABLE
        #endif
    #else
        #define BIAP_NONNULL
        #define BIAP_NULLABLE
    #endif

#endif /* DOXYGEN_SHOULD_IGNORE_THIS */




#include <stddef.h>
#include <stdint.h>
#include <stdbool.h>

struct BIAP_AppStore;
typedef struct BIAP_AppStore BIAP_AppStore;

struct BIAP_ProductResponseData;
struct BIAP_TransactionResponseData;
typedef struct BIAP_ProductResponseData BIAP_ProductResponseData;
typedef struct BIAP_TransactionResponseData BIAP_TransactionResponseData;

struct BIAP_Product;
typedef struct BIAP_Product BIAP_Product;


enum BIAP_StoreName
{
    BIAP_STORE_UNKNOWN = -2,
    BIAP_STORE_DEFAULT = -1,
    BIAP_STORE_NONE = 0,
    BIAP_STORE_APPLE,
    BIAP_STORE_GOOGLEPLAY,
    BIAP_STORE_AMAZON,
    BIAP_STORE_SAMSUNG,
    BIAP_STORE_NOKIA,
    BIAP_STORE_APPLAND,
    BIAP_STORE_APTOIDE,
    BIAP_STORE_APPMALL,
    BIAP_STORE_SLIDEME,
    BIAP_STORE_YANDEX,
    BIAP_STORE_FORTUMO,
    BIAP_STORE_SKUBIT,
    BIAP_STORE_SKUBITTEST,
    BIAP_STORE_WINDOWSSTORE
};
typedef enum BIAP_StoreName BIAP_StoreName;


    


    

enum BIAP_EventType
{
    BIAP_EVENT_UNKNOWN = 0, 

    BIAP_EVENT_INIT_FAILED, 
    BIAP_EVENT_INIT_FINISHED, 
    
    BIAP_EVENT_REQUEST_FAILED, 

    BIAP_EVENT_PRODUCT_REQUEST, 
    
    BIAP_EVENT_TRANSACTION_FAILED, 
    
    BIAP_EVENT_TRANSACTION_PURCHASING, 
    BIAP_EVENT_TRANSACTION_PURCHASED, 

    BIAP_EVENT_TRANSACTION_PURCHASE_CANCELLED, 
    BIAP_EVENT_TRANSACTION_PURCHASE_REFUNDED, 

    BIAP_EVENT_TRANSACTION_RESTORED, 
    BIAP_EVENT_TRANSACTION_RESTORE_FINISHED, 
    BIAP_EVENT_TRANSACTION_RESTORE_FAILED, 

    BIAP_EVENT_TRANSACTION_DEFFERED, 

    BIAP_EVENT_TRANSACTION_CONSUMED, 
    BIAP_EVENT_TRANSACTION_CONSUMED_FAILED, 
    
    BIAP_EVENT_TRANSACTION_RECEIPT_REQUEST_FINISHED, 
    BIAP_EVENT_TRANSACTION_RECEIPT_REQUEST_FAILED, 

    
};
typedef enum BIAP_EventType BIAP_EventType;

enum BIAP_FailedTransactionType
{
    BIAP_FAILED_TRANSACTION_NONE = -1,
    BIAP_FAILED_TRANSACTION_OTHER_ERROR = 0,
    BIAP_FAILED_TRANSACTION_USER_CANCELLED,
    BIAP_FAILED_TRANSACTION_PAYMENT_INVALID, 
    BIAP_FAILED_TRANSACTION_PAYMENT_NOT_ALLOWED, 
    BIAP_FAILED_TRANSACTION_CLIENT_INVALID, 
    BIAP_FAILED_TRANSACTION_BILLING_UNAVAILABLE, 
    BIAP_FAILED_TRANSACTION_ITEM_UNAVAILABLE, 
    BIAP_FAILED_TRANSACTION_ITEM_ALREADY_OWNED, 
    BIAP_FAILED_TRANSACTION_DEVELOPER_ERROR, 
    BIAP_FAILED_TRANSACTION_NOT_SUPPORTED, 
};
typedef enum BIAP_FailedTransactionType BIAP_FailedTransactionType;



typedef void (*BIAP_ProductResponse)(enum BIAP_EventType callback_type, struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, void* BIAP_NULLABLE user_data);
typedef void (*BIAP_TransactionResponse)(enum BIAP_EventType callback_type, struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data, void* BIAP_NULLABLE user_data);

BIAP_EXPORT void BIAP_FreeProductResponseData(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);
BIAP_EXPORT void BIAP_FreeTransactionResponseData(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);




BIAP_EXPORT void BIAP_RegisterKey(enum BIAP_StoreName store_name, const char* BIAP_NONNULL the_key);


BIAP_EXPORT void BIAP_Init(void);
BIAP_EXPORT bool BIAP_IsInit(void);
BIAP_EXPORT void BIAP_Quit(void);

BIAP_EXPORT struct BIAP_AppStore* BIAP_NONNULL BIAP_CreateAppStore(enum BIAP_StoreName store_name, void* BIAP_NULLABLE native_platform_context, BIAP_ProductResponse BIAP_NONNULL product_response_callback, BIAP_TransactionResponse BIAP_NONNULL transaction_response_callback, void* BIAP_NULLABLE user_data);

BIAP_EXPORT void BIAP_StartAppStore(struct BIAP_AppStore* BIAP_NONNULL app_store);

BIAP_EXPORT void BIAP_FreeAppStore(struct BIAP_AppStore* BIAP_NONNULL app_store);


    


BIAP_EXPORT enum BIAP_StoreName BIAP_GetAppStoreName(struct BIAP_AppStore* BIAP_NONNULL app_store);


    

BIAP_EXPORT void BIAP_RequestProducts(struct BIAP_AppStore* BIAP_NONNULL app_store,
    const char* BIAP_NULLABLE nonconsumable_product_identifier_list[BIAP_NONNULL], size_t num_nonconsumables,
    const char* BIAP_NULLABLE consumable_product_identifier_list[BIAP_NONNULL], size_t num_consumables,
    const char* BIAP_NULLABLE subscription_product_identifier_list[BIAP_NONNULL], size_t num_subscriptions
);

BIAP_EXPORT void BIAP_PurchaseProduct(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, struct BIAP_Product* BIAP_NONNULL the_product);

BIAP_EXPORT void BIAP_FinishTransaction(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT void BIAP_ConsumePurchase(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data_of_purchase);


BIAP_EXPORT void BIAP_RestorePurchases(struct BIAP_AppStore* BIAP_NONNULL app_store);


    




BIAP_EXPORT struct BIAP_AppStore* BIAP_NONNULL BIAP_GetProductAppStore(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);


BIAP_EXPORT enum BIAP_EventType BIAP_GetProductEventType(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetProductErrorString(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT size_t BIAP_GetProductsListCount(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT struct BIAP_Product* BIAP_NULLABLE BIAP_GetProductInList(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, size_t list_index);

BIAP_EXPORT struct BIAP_Product* BIAP_NULLABLE BIAP_GetProductWithIdentifier(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, const char* BIAP_NONNULL product_identifer);
    
BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetProductTitle(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, struct BIAP_Product* BIAP_NONNULL product_object);
BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetProductDescription(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, struct BIAP_Product* BIAP_NONNULL product_object);
BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetProductIdentifier(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, struct BIAP_Product* BIAP_NONNULL product_object);
BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetProductLocalizedPrice(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, struct BIAP_Product* BIAP_NONNULL product_object);


BIAP_EXPORT size_t BIAP_GetInvalidProductsListCount(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetInvalidProductIdentifier(struct BIAP_ProductResponseData* BIAP_NONNULL callback_data, size_t list_index);


    
    

BIAP_EXPORT struct BIAP_AppStore* BIAP_NONNULL BIAP_GetTransactionAppStore(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT enum BIAP_EventType BIAP_GetTransactionEventType(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetTransactionErrorString(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT enum BIAP_FailedTransactionType BIAP_GetTransactionErrorType(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetTransactionProductIdentifier(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT long long BIAP_GetTransactionPurchaseTime(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT long long BIAP_GetTransactionOriginalPurchaseTime(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetTransactionOriginalJson(struct BIAP_TransactionResponseData* BIAP_NONNULL callback_data);


    
    
BIAP_EXPORT void BIAP_RequestReceiptRefresh(struct BIAP_AppStore* BIAP_NONNULL app_store);

BIAP_EXPORT const char* BIAP_NONNULL BIAP_GetReceiptPath(struct BIAP_AppStore* BIAP_NONNULL app_store);



    
BIAP_EXPORT void BIAP_SetDebugLogging(bool should_enable);
BIAP_EXPORT bool BIAP_IsDebugLogging(void);

    

#if defined(__ANDROID__)

BIAP_EXPORT bool BIAP_Android_HandleOnActivityResult(void* BIAP_NONNULL jni_env, void* BIAP_NONNULL original_activity, int32_t request_code, int32_t result_code, void* BIAP_NONNULL intent_data);
#endif

    
    
#if defined(__cplusplus)
}
#endif

#endif /* BLURRR_IN_APP_PURCHASE_H */