ProductsObtainer

Preparation

This API become available with advanced Magify SDK integration are described here.

Overview

This service is responsible for performing the obtaining all kinds of campaign products (ProductDef). In addition to the embedded handlers, you will also be able to add custom obtainers in case you need specific logic to obtain any types of products.

OnProductObtainBegan

IObservable<ProductDef> OnProductObtainBegan { get; }

If the IProductObtainer has been successfully found and the product is ready to be obtained then this observable will be notified at the very beginning of the process.

OnProductObtained

IObservable<ProductObtainResult> OnProductObtained { get; }

If the product was successfully obtained then this observable will be notified.

OnProductObtainFinished

IObservable<ProductObtainResult> OnProductObtainFinished { get; }

At the very end, after the obtaining has been processed, this observable will be notified regardless of whether the product was successfully received or whether some error occurred.

RegisterCampaignHandler

void RegisterCampaignHandler(IProductObtainer obtainer)

Allows you to register a custom product obtain handler. Custom handlers always take precedence over embedded handlers.

CanObtainProduct

bool CanObtainProduct(ProductDef product)

Returns true if any handler that can handle this product (embedded or custom) was found.

ObtainProductAsync

UniTask<ProductObtainResult> ObtainProductAsync(ProductDef product, CampaignRequest request, CancellationToken cancellationToken)

Performs the process of obtaining a product using embedded or custom obtain handler.