- Scan NFC Tag (see below about supported tags)
- Scan custom NFC tags
- IC cards for transit in Japan
- Suica, Pasmo, Kitaca, ICOCA, TOICA, manaca, PiTaPa, nimoca, SUGOCA, はやかけん
- IC cards for shopping in Japan
- nanaco
- Edy
- WAON
- Xcode 11.x
- Swift 5.1+
- iOS 13.0+
- iPhone 7 and later
You can install this framework with Swift Package Manager in Xcode 11.
github "tattn/NFCReader"
NFCReader uses Core NFC, so you need to add the following setting:
- Add
Near Field Communication Tag Reading
to Capabilities. - Add
Privacy - NFC Scan Usage Description
to Info.plist. - Add system codes of the card you want to scan to Info.plist.
Card | System code |
---|---|
Transit cards in Japan | 0003 |
nanaco, Edy, WAON | FE00 |
import NFCReader
let reader = Reader<Suica>() // `Nanaco`, `Edy` or `Waon`
reader.read(didBecomeActive: { _ in
print("didBecomeActive")
}, didDetect: { reader, result in
switch result {
case .success(let suica):
let balance = suica.boardingHistory.first?.balance ?? 0
reader.setMessage("Your balance is ¥\(balance) .")
case .failure(let error):
reader.setMessage("something wrong")
}
})
You can see more details at Sources/NFCReader/Tags
:
let reader = Reader<FeliCa>
reader.read(didDetect: { reader, result in
switch result {
case .success(let tag):
switch tag {
case .edy(let edy):
print(edy)
case .nanaco(let nanaco):
print(nanaco)
case .waon(let waon):
print(waon)
case .suica(let suica):
print(suica)
}
case .failure(let error):
print(error)
}
})
The reader can also read just specific tags. Please see Sources/NFCReader/Tags/FeliCa/FeliCa.swift
.
reader.read(didDetect: { reader, result in
switch result {
case .success(let suica):
let balance = suica.boardingHistory.first?.balance ?? 0
reader.setMessage("Your balance is ¥\(balance) .")
reader.restartReading() // continue to scan
case .failure(let error):
reader.setMessage("something wrong")
reader.restartReading()
}
})
var configuration = ReaderConfiguration()
configuration.message.alert = "Hold your iPhone near the Suica."
let reader = Reader<Suica>(configuration: configuration)
Please see ./Sources/NFCReader/Tags/FeliCa/nanaco/Nanaco.swift
.
- Decode entrance and exit histories of Suica. (service code: 108F)
- Decode SF entrance histories of Suica. (service code: 10CB)
- Support more NFC tags.
- Fork it!
- Create your feature branch:
git checkout -b my-new-feature
- Commit your changes:
git commit -am 'Add some feature'
- Push to the branch:
git push origin my-new-feature
- Submit a pull request :D
Donating to help me continue working on this project.
NFCReader is released under the MIT license. See LICENSE for details.
Tatsuya Tanaka