एंड्रॉइड एप्लिकेशन में इन-ऐप खरीदारी या आंतरिक भुगतान

यह सब क्या है?

एंड्रॉइड प्लेटफॉर्म के लिए एप्लिकेशन के डेवलपर्स के लिए एंड्रॉइड मार्केट एप्लिकेशन 2.3.0 के संस्करण के साथ, उपयोगकर्ताओं को स्वयं अनुप्रयोगों के भीतर भुगतान प्रदान करने के लिए अवसर खोला गया है। अब आप केवल बिल्ट-इन प्लेटफ़ॉर्म टूल का उपयोग करके स्तरों और कलाकृतियों, वीडियो, संगीत, प्लगइन्स और अधिक को बेच सकते हैं। आइए देखें कि यह कैसे किया जा सकता है।

हमें क्या चाहिए?

हमेशा की तरह, मेरा पसंदीदा आईडीई, एंड्रॉइड एसडीके और नमूना आवेदन ।
यह कल्पना करना भी उपयोगी होगा कि सेवा, ब्रॉडकास्टसीवर और निश्चित रूप से, गतिविधि क्या है।

हमें मैनिफ़ेस्ट फ़ाइल में भी अनुमति चाहिए -

<uses-permission android:name="com.android.vending.BILLING"/> , इसके बिना कुछ भी काम नहीं करेगा।

सिद्धांत रूप में यह कैसे काम करता है?

एंड्रॉइड मार्केट एप्लिकेशन में सेवा के माध्यम से सब कुछ काम करता है। वह जानता है कि एक निश्चित चीज़ के विवरण के लिए अनुरोध कैसे भेजें, जिसे उपयोगकर्ता खरीदना चाहता है, खरीदने के लिए, खरीद की सफलता या विफलता के बारे में उत्तर प्राप्त करता है, और इसी तरह। आपके द्वारा बेची जाने वाली चीजों के बारे में सभी जानकारी एक विशिष्ट एप्लिकेशन के लिए डेवलपर कंसोल के माध्यम से स्थापित की जानी चाहिए। जैसे ही हमें एक सफल खरीद के बारे में संकेत मिला, हम अपने सर्वर से सामग्री लोड करना शुरू कर सकते हैं।

यह सब कैसे काम करता है?

सर्वर पर, बाजार उन चीजों के बारे में जानकारी संग्रहीत करता है जिन्हें आप खरीद सकते हैं। बाजार का क्लाइंट एप्लिकेशन सर्वर के साथ इंटरैक्ट करता है। हमारा आवेदन इसके साथ सहभागिता करता है।

हमारे आवेदन में कम से कम शामिल होंगे:

1. BillingService। यह एक ऐसी सेवा है जो बाजार के अनुप्रयोग से जुड़ी है, और उसे परिचालन के बारे में सभी जानकारी भेजती है और उन्हें जवाब देती है, यदि वे समकालिक हैं।
2. BillingReceiver। एक बाजार आवेदन से अतुल्यकालिक प्रतिक्रियाएं मिलती हैं।
3. PurchaseObserver। एक इकाई जो खरीद स्थिति में परिवर्तन के UI को सूचित करेगी।

हम बाजार को क्या संदेश भेजते हैं?

सबसे पहले, हमें MarketBilling सेवा की SendBillingRequest विधि को कॉल करने के लिए अपने बिलिंग सेवा को बाज़ार एप्लिकेशन से कनेक्ट करना होगा। सेवा इंटरफ़ेस को IMarketBillingService.aidl फ़ाइल में वर्णित किया गया है, इसे डाउनलोड किया जा सकता है यहाँ से, और इसे com.android.vending.billing में अपने आवेदन के पैकेज में डालें। IDE को तुरंत IMarketBillingService.java फ़ाइल तैयार करनी चाहिए, जिसे हमें उपरोक्त विधि से कॉल करना होगा।

विधि खुद एक बंडल पैरामीटर लेती है, जो सभी जानकारी संग्रहीत करती है। सबसे महत्वपूर्ण "BILLING_REQUEST" कुंजी के साथ पैरामीटर है। यह अनुरोध के प्रकार को निर्धारित करता है। वे हैं:

• CHECK_BILLING_SUPPORTED - इन-ऐप बिलिंग की उपलब्धता की जाँच करें।
• REQUEST_PURCHASE खरीद - खरीद अनुरोध।
• GET_PURCHASE_INFORMATION - खरीद स्थिति में परिवर्तन के बारे में जानकारी प्राप्त करना।
• CONFIRM_NOTIFICATIONS - बाजार के आवेदन से एक अधिसूचना प्राप्त करने के तथ्य की पुष्टि।
• RESTORE_TRANSACTIONS - पहले से खरीदी गई वस्तुओं पर लेनदेन बहाल करें।

जवाब क्या हैं?

विधि तुल्यकालिक रूप से एक प्रतिक्रिया देता है, जो एक बंडल भी है। इसमें शामिल हैं:

• RESPONSE_CODE - प्रतिक्रिया कोड
• PURCHASE_INTENT - खरीद गतिविधि शुरू करने के लिए PendingIntent ।
• REQUEST_ID - भेजे गए अनुरोध की पहचानकर्ता

अतुल्यकालिक प्रतिक्रियाओं के मामले में (BillingReceiver के माध्यम से प्राप्त), उनमें निम्नलिखित शामिल हैं:

• com.android.vending.billing.RESPONSE_CODE
प्रतिक्रिया कोड। बाजार अनुरोध की सफलता या विफलता की पुष्टि करता है।

• com.android.vending.billing.IN_APP_NOTIFY
चेतावनी कि खरीद की स्थिति बदल गई है। इस संदेश के बाद, आपको जानकारी प्राप्त करने के लिए GET_PURCHASE_INFORMATION प्रकार के साथ एक अनुरोध भेजना होगा।

• com.android.vending.billing.PURCHASE_STATE_CHANGED
और फिर खरीद के बारे में विस्तृत जानकारी आती है। इसमें नॉनस, ऑर्डर की एक सूची, उत्पाद पहचानकर्ताओं, उनकी स्थितियों और इतने पर संकेत शामिल हैं।

खरीद के लिए अनुक्रम निम्नानुसार होगा:

1. हम REQUEST_PURCHASE भेजें
2. एक तुल्यकालिक प्रतिक्रिया प्राप्त करें
3. लॉन्च गतिविधि खरीद (भी बाजार एप्लिकेशन में बनाया गया है)
4. हमें अतुल्यकालिक संदेश IN_APP_NOTIFY प्राप्त होता है
5. GET_PURCHASE_INFORMATION
6. हमें एक तुल्यकालिक प्रतिक्रिया मिलती है
7. हमें अतुल्यकालिक प्रतिक्रिया PURCHASE_STATE_CHANGED प्राप्त होती है
8. भेजना CONFIRM_NOTIFICATIONS
9. हमें एक तुल्यकालिक प्रतिक्रिया मिलती है

या शायद हम कोड को बेहतर तरीके से देखेंगे?

तो, कोड में मुख्य बिंदु:

1. बाजार से कनेक्ट करें।

OnCreate () बिलिंग सेवा में हम लिखते हैं:

try {
boolean bindResult = getApplicationContext().bindService(
new Intent( "com.android.vending.billing.MarketBillingService.BIND" ),
this ,
Context.BIND_AUTO_CREATE);
if (bindResult) {
Log.i(TAG, "Service bind successful." );
} else {
Log.e(TAG, "Could not bind to the MarketBillingService." );
}
} catch (SecurityException e) {
Log.e(TAG, "Security exception: " + e);
}

// :
@Override
public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
Log.i(TAG, "MarketBillingService connected." );
marketService = IMarketBillingService.Stub.asInterface(iBinder);
runPendingRequests();
}

* This source code was highlighted with Source Code Highlighter .

2. अनुरोध भेजना।

नमूना आवेदन में, प्रश्नों के लिए एक श्रेणी पदानुक्रम बनाया गया है और यह सही है। उनके बारे में सबसे महत्वपूर्ण बात शिपिंग में देरी है। तथ्य यह है कि bindService असिंक्रोनस रूप से होता है, जिसका अर्थ है कि हमें MarketBillingService का लिंक बहुत बाद में onCreate () समाप्त होता है, और यहां तक ​​कि बाद में जब हम पहली बार अनुरोधों को निष्पादित करने का प्रयास करते हैं। इसलिए, हम यह करते हैं:

/**
* Run the request, starting the connection if necessary.
*
* @return this request if the request was not executed in order to queue it.
*/
public final AbstractRequest runRequest() {
if (runIfConnected()) {
return null ;
}
return this ;
}

/**
* Try running the request directly if the service is already connected.
*
* @return true if the request ran successfully; false if the service
* is not connected or there was an error when trying to use it
*/
public boolean runIfConnected() {
if (service.isConnected()) {
try {
requestId = run();
if (requestId >= 0) {
service.addRequest(requestId, this );
}
return true ;
} catch (MyException e) {
onException(e);
}
}
return false ;
}

* This source code was highlighted with Source Code Highlighter .

अनुरोध की वापसी सेवा में लंबित अनुरोधों की सूची में इसे याद रखने के लिए आवश्यक है। फिर, जब हमें OnServiceConnected () में MarketBillingService का लिंक मिलता है, तो हम सभी अनुरोधों को फिर से भेजने का प्रयास करेंगे।

3. यूआई अधिसूचना

बिलिंग सेवा में हम अपने यूआई से हैंडलर को स्टोर करने वाली कुछ इकाई के लिए एक लिंक स्टोर करेंगे। फिर, उत्तर प्राप्त करने के बाद, यह करना संभव होगा:

private void notifyGui( int messageId, PurchasedItem item) {
if (observer != null ) {
observer.notifyGui(messageId, item);
} else {
// NotificationBar
}
}

* This source code was highlighted with Source Code Highlighter .

महत्वपूर्ण: इसे बाहर निकालते समय और इस लिंक को पुनर्स्थापित करते समय अपनी गतिविधि से पर्यवेक्षक सेवा को रीसेट करना न भूलें। यह निम्नानुसार किया जाता है:

@Override
protected void onUserLeaveHint() {
if (billingService != null ) {
unbindService( this );
billingService.resetEventDispatcher();
billingService = null ;
}
super.onUserLeaveHint();
}

@Override
public void onServiceConnected(ComponentName componentName, IBinder iBinder) {
//Connected to BillingService
if (componentName.getShortClassName().equals(serviceClassName)) {
billingService = ((BillingService.LocalBinder) iBinder).getService();
billingService.setObserver( new PurchaseObserver());
try {
billingService.checkBillingAvailability();
} catch (MyException e) {
Log.e(TAG, "Billing unavailable" , e);
Toast.makeText( this , "Billing unavailable" , Toast.LENGTH_LONG).show();
}
}
}

* This source code was highlighted with Source Code Highlighter .

4. गतिविधि गतिविधि लॉन्च करें।

परचेज़ऑब्जर्वर उदाहरण वर्ग पर एक नज़र डालें। एक विधि है सार्वजनिक शून्य startBuyPageActivity (लंबित लंबित लंबित, आशय इरादे)। PendingIntent जो हमें बाजार से मिला है। और आशय सिर्फ नया आशय () है।
यह विधि क्या करती है?
वास्तव में, आपकी गतिविधि का उदाहरण इस वर्ग को दिया जाता है। इसके अलावा, परावर्तन के माध्यम से, स्टार्टस्टेंस्टेंडर पद्धति प्राप्त करने का प्रयास किया जाता है। यह विधि केवल एंड्रॉइड 2.0 में दिखाई दी। यदि यह है, तो विधि कहा जाता है, और गतिविधि हमारे आवेदन के गतिविधि स्टैक में शुरू होती है। यदि विधि नहीं मिली है, तो गतिविधि एक अलग स्टैक पर शुरू होती है।

लेकिन सुरक्षा का क्या?

सुरक्षा का मुद्दा एक अलग लेख का विषय है, और पहले से ही कई हैं। नमूना आवेदन में, सुरक्षा के लिए सुरक्षा वर्ग जिम्मेदार है। मैं केवल इतना कह सकता हूं कि आपको खरीदारी को सत्यापित करने की आवश्यकता नहीं है (जैसा कि उदाहरण में किया गया था), लेकिन अपने स्वयं के सर्वर पर, ताकि संभावित तर्क मालिकों के हाथों को सत्यापन तर्क न दिया जा सके।

PS डेवलपर. android.com/guide/market/billing/billing_overview.html पर आधारित है