Всем доброго времени суток
Последние несколько месяцев занимаюсь разработкой гибридных мобильных приложений, с использованием Ionic фраемворка и Cordova плагинов. Поскольку сам Ionic использует AngularJs, то использование библиотеки ngCordova было очень удобным из-за Angular обертки.
Но возникла необходимость внедрить в проект поддержку сервиса CardIO. CardIO предоставляет функционал для сканирования фронтальной части кредитной карты. Информация о cvv вводится вручную.
Поискав на сайте Cordova плагин для этого сервиса, и выбрав среди нескольких существующих вариантов, остановился на этом — Plugin. Использовать его в чистом виде не хотелось, потому решил написать Angular обертку для этого плагина, для его дальнейшего использования.
В итоге получилось следующее angular-cordova-cardio
Данная Библиотека предоставляет Сервис и Провайдер для его настройки.
Пример использования библиотеки:
angular.module('habraExample', ['ngCardIO']) .config(['$cordovaNgCardIOProvider', function ($cordovaNgCardIOProvider) { $cordovaNgCardIOProvider.setScanerConfig( { "expiry": true, "cvv": true, "zip": false, "suppressManual": false, "suppressConfirm": false, "hideLogo": true } ); $cordovaNgCardIOProvider.setCardIOResponseFields( [ "card_type", "redacted_card_number", "card_number", "expiry_month", "expiry_year", "cvv", "zip" ] ); }] ) .controller('TestCtrl', function ($scope, $cordovaNgCardIO) { $scope.scan = function () { $cordovaNgCardIO.scanCard().then( function (response) { //response is an object with scan data } ); } } );
Сервис Возвращает promise.
В случае его resolve — возвращается данные карты.
В случае reject, я все время возвращаю null. (из-за того что в самой библиотеке в errorСallback не возвращается ничего. Да и как таковой ошибки тут возникнуть не может. Объясню:
Работа плагина заключается в следующем:
— Мы нажимаем сканировать карту, открывается окно с поиском и сканирования
— В случае первого запуска идет запрос на получения прав доступа приложения к камере. Если мы не разрешили, или камера сломана, или не доступна по любой причине, автоматически откроется диалог ручного ввода данных карты.
— Так же есть кнопка переключения между ручным вводом и камерой(если она доступна).
— Если данные не удалось распознать то не достающие данные вводятся вручную.
— После чего кнопка Done и вызовет successCallback.
— Только в случае отмены сканирования или ручного ввода — вызовет errorCallback — в который ничего не передается. И я просто возвращаю null.
Что касается $cordovaNgCardIOProvider, то он имеет два метода
setScanerConfig — для установки параметров сканирования
"expiry": true, //Использовать expire date в ручном вводе или при сканировании "cvv": true, //Использовать cvv в ручном вводе или при сканировании "zip": false, //Использовать zip в ручном вводе или при сканировании "suppressManual": false, // Это и 3 параметра ниже не уверен для чего они... судя по названию должны подавлять (запрещать) ручной ввод... но этого не происходит. "suppressConfirm": false, "hideLogo": true
setCardIOResponseFields — После сканирования в successCallBack идет возврат всех полей которые были считаны. Используя этот параметр, мы можем отсечь часть данных перед возвратом пользователю.
//список полей которые можно передать. "card_type", //Тип карты Visa|MasterCard etc "redacted_card_number", // Номер карты в скрытом режиме **** **** **** 1234 "card_number", //Полный номер карты 1234 5678 9000 1234 "expiry_month", //Месяц 01 02 etc "expiry_year", // Год 2015 2016 "cvv", // сvv "zip" // Если был запрошен в параметре выше
В ближайшее время выложу в bower репозитории, и планирую сделать PR в ngCordova.
Так же хочу расширить возвращаемые данные что бы год возвращался в формате 2 чисел, а не 4 как возвращает Сordova plugin.
ссылка на оригинал статьи http://habrahabr.ru/post/260437/
Добавить комментарий