AbstractBillingActivity.java

/*   Copyright 2011 Robot Media SL (http://www.robotmedia.net)
 *
 *   Licensed under the Apache License, Version 2.0 (the "License");
 *   you may not use this file except in compliance with the License.
 *   You may obtain a copy of the License at
 *
 *       http://www.apache.org/licenses/LICENSE-2.0
 *
 *   Unless required by applicable law or agreed to in writing, software
 *   distributed under the License is distributed on an "AS IS" BASIS,
 *   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *   See the License for the specific language governing permissions and
 *   limitations under the License.
 */

package net.robotmedia.billing.helper;

import android.app.Activity;
import net.robotmedia.billing.BillingController;
import net.robotmedia.billing.BillingController.BillingStatus;
import net.robotmedia.billing.BillingRequest.ResponseCode;
import net.robotmedia.billing.model.Transaction.PurchaseState;

public abstract class AbstractBillingActivity extends Activity implements BillingController.IConfiguration {

    protected AbstractBillingObserver mBillingObserver;

    /**
     * <p>
     * Returns the in-app product billing support status, and checks it
     * asynchronously if it is currently unknown.
     * {@link AbstractBillingActivity#onBillingChecked(boolean)} will be called
     * eventually with the result.
     * </p>
     * <p>
     * In-app product support does not imply subscription support. To check if
     * subscriptions are supported, use
     * {@link AbstractBillingActivity#checkSubscriptionSupported()}.
     * </p>
     *
     * @return the current in-app product billing support status (unknown,
     *         supported or unsupported). If it is unsupported, subscriptions
     *         are also unsupported.
     * @see AbstractBillingActivity#onBillingChecked(boolean)
     * @see AbstractBillingActivity#checkSubscriptionSupported()
     */
    public BillingStatus checkBillingSupported() {
        return BillingController.checkBillingSupported(this);
    }

    /**
     * <p>
     * Returns the subscription billing support status, and checks it
     * asynchronously if it is currently unknown.
     * {@link AbstractBillingActivity#onSubscriptionChecked(boolean)} will be
     * called eventually with the result.
     * </p>
     * <p>
     * No support for subscriptions does not imply that in-app products are also
     * unsupported. To check if subscriptions are supported, use
     * {@link AbstractBillingActivity#checkSubscriptionSupported()}.
     * </p>
     *
     * @return the current in-app product billing support status (unknown,
     *         supported or unsupported). If it is unsupported, subscriptions
     *         are also unsupported.
     * @see AbstractBillingActivity#onBillingChecked(boolean)
     * @see AbstractBillingActivity#checkSubscriptionSupported()
     */
    public BillingStatus checkSubscriptionSupported() {
        return BillingController.checkSubscriptionSupported(this);
    }

    public abstract void onBillingChecked(boolean supported);

    public abstract void onSubscriptionChecked(boolean supported);

    @Override
    protected void onCreate(android.os.Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        mBillingObserver = new AbstractBillingObserver(this) {

            public void onBillingChecked(boolean supported) {
                AbstractBillingActivity.this.onBillingChecked(supported);
            }

            public void onSubscriptionChecked(boolean supported) {
                AbstractBillingActivity.this.onSubscriptionChecked(supported);
            }

            public void onPurchaseStateChanged(String itemId, PurchaseState state) {
                AbstractBillingActivity.this.onPurchaseStateChanged(itemId, state);
            }

            public void onRequestPurchaseResponse(String itemId, ResponseCode response) {
                AbstractBillingActivity.this.onRequestPurchaseResponse(itemId, response);
            }
        };
        BillingController.registerObserver(mBillingObserver);
        BillingController.setConfiguration(this); // This activity will provide
        // the public key and salt
        this.checkBillingSupported();
        if (!mBillingObserver.isTransactionsRestored()) {
            BillingController.restoreTransactions(this);
        }
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        BillingController.unregisterObserver(mBillingObserver); // Avoid
        // receiving
        // notifications after
        // destroy
        BillingController.setConfiguration(null);
    }

    public abstract void onPurchaseStateChanged(String itemId, PurchaseState state);

    ;

    public abstract void onRequestPurchaseResponse(String itemId, ResponseCode response);

    /**
     * Requests the purchase of the specified item. The transaction will not be
     * confirmed automatically; such confirmation could be handled in
     * {@link AbstractBillingActivity#onPurchaseExecuted(String)}. If automatic
     * confirmation is preferred use
     * {@link BillingController#requestPurchase(android.content.Context, String, boolean)}
     * instead.
     *
     * @param itemId id of the item to be purchased.
     */
    public void requestPurchase(String itemId) {
        BillingController.requestPurchase(this, itemId);
    }

    /**
     * Requests the purchase of the specified subscription item. The transaction
     * will not be confirmed automatically; such confirmation could be handled
     * in {@link AbstractBillingActivity#onPurchaseExecuted(String)}. If
     * automatic confirmation is preferred use
     * {@link BillingController#requestPurchase(android.content.Context, String, boolean)}
     * instead.
     *
     * @param itemId id of the item to be purchased.
     */
    public void requestSubscription(String itemId) {
        BillingController.requestSubscription(this, itemId);
    }

    /**
     * Requests to restore all transactions.
     */
    public void restoreTransactions() {
        BillingController.restoreTransactions(this);
    }

}