Final yr, iOS 15 got here with a really helpful characteristic often called Stay Textual content. You will have heard of the time period OCR (quick for Optical Character Recognition), which is the method for changing a picture of textual content right into a machine-readable textual content format. That is what Stay Textual content is about.
Stay Textual content is built-into the digicam app and Photographs app. In the event you haven’t tried out this characteristic, merely open the Digicam app. While you level the machine’s digicam at a picture of textual content, you will see a Stay Textual content button on the lower-right nook. By tapping the button, iOS routinely captures the textual content for you. You possibly can then copy and paste it into different purposes (e.g. Notes).
This can be a very highly effective and handy options for many customers. As a developer, wouldn’t or not it’s nice for those who can incorporate this Stay Textual content characteristic in your personal app? In iOS 16, Apple launched the Stay Textual content API for builders to energy their apps with Stay Textual content. On this tutorial, let’s see use the Stay Textual content API with SwiftUI.
Allow Stay Textual content Utilizing DataScannerViewController
Within the WWDC session about Capturing Machine-readable Codes and Textual content with VisionKit, Apple’s engineer confirmed the next diagram:
Textual content recognization isn’t a brand new characteristic on iOS 16. On older model of iOS, you should utilize APIs from the AVFoundation and Imaginative and prescient framework to detect and acknowledge textual content. Nevertheless, the implementation is sort of sophisticated, particularly for individuals who are new to iOS improvement.
Within the subsequent launch of iOS, all of the above is simplified to a brand new class known as DataScannerViewController
in VisionKit. By utilizing this view controller, your app can routinely show a digicam UI with the Stay Textual content functionality.
To make use of the category, you first import the VisionKit
framework after which examine if the machine helps the info scanner characteristic:
DataScannerViewController.isSupported |
The Stay Textual content API solely helps gadgets launched in 2018 or newer with Neural engine. On high of that, you additionally have to examine the provision to see if the person approves the usage of knowledge scanner:
DataScannerViewController.isAvailable |
As soon as each checks come again with constructive outcomes, you’re prepared to start out the scanning. Right here is the pattern code to launch a digicam with Stay Textual content:
current(dataScanner, animated: true) {
attempt? dataScanner.startScanning()
}
let dataScanner = DataScannerViewController( recognizedDataTypes: [.text()], qualityLevel: .balanced, isHighlightingEnabled: true )
current(dataScanner, animated: true) { attempt? dataScanner.startScanning() } |
All you want is create an occasion of DataScannerViewController
and specify the acknowledged knowledge varieties. For textual content recognition, you go .textual content()
as the info kind. As soon as the occasion is prepared, you possibly can current it and begin the scanning course of by calling the startScanning()
methodology.
Working with DataScannerViewController in SwiftUI
The DataScannerViewController
class now solely helps UIKit. For SwiftUI, it wants a bit of labor. Now we have to undertake the UIViewControllerRepresentable
protocol to make use of the category in SwiftUI tasks. On this case, I create a brand new struct named DataScanner
like this:
struct DataScanner: UIViewControllerRepresentable { . . . } |
This struct accepts two binding variables: one for triggering the info scanning and the opposite is a binding for storing the scanned textual content.
@Binding var startScanning: Bool @Binding var scanText: String |
To efficiently undertake the UIViewControllerRepresentable
protocol, we have to implement the next strategies:
return controller
}
func updateUIViewController(_ uiViewController: DataScannerViewController, context: Context) {
if startScanning {
attempt? uiViewController.startScanning()
} else {
uiViewController.stopScanning()
}
}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 |
func makeUIViewController(context: Context) –> DataScannerViewController { let controller = DataScannerViewController( recognizedDataTypes: [.text()], qualityLevel: .balanced, isHighlightingEnabled: true )
return controller }
func updateUIViewController(_ uiViewController: DataScannerViewController, context: Context) {
if startScanning { attempt? uiViewController.startScanning() } else { uiViewController.stopScanning() } } |
Within the makeUIViewController
methodology, we return an occasion of DataScannerViewController
. For updateUIViewController
, we begin (or cease) the scanning relying on the worth of startScanning
.
To seize the scanned textual content, we now have to undertake the next methodology of DataScannerViewControllerDelegate
:
func dataScanner(_ dataScanner: DataScannerViewController, didTapOn merchandise: RecognizedItem) { . . . } |
The strategy is known as when the person faucets the detected textual content, so we’ll implement it like this:
init(_ father or mother: DataScanner) {
self.father or mother = father or mother
}
func dataScanner(_ dataScanner: DataScannerViewController, didTapOn merchandise: RecognizedItem) {
change merchandise {
case .textual content(let textual content):
father or mother.scanText = textual content.transcript
default: break
}
}
}
func makeCoordinator() -> Coordinator {
Coordinator(self)
}
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 |
class Coordinator: NSObject, DataScannerViewControllerDelegate { var father or mother: DataScanner
init(_ father or mother: DataScanner) { self.father or mother = father or mother }
func dataScanner(_ dataScanner: DataScannerViewController, didTapOn merchandise: RecognizedItem) { change merchandise { case .textual content(let textual content): father or mother.scanText = textual content.transcript default: break } }
}
func makeCoordinator() –> Coordinator { Coordinator(self) } |
We examine the acknowledged merchandise and retailer the scanned textual content if any textual content is acknowledged. Lastly, insert this line of code within the makeUIViewController
methodology to configure the delegate:
controller.delegate = context.coordinator |
This controller is now prepared to be used in SwiftUI views.
Capturing Textual content Utilizing DataScanner
For instance, we’ll construct a textual content scanner app with a quite simple person interface. When the app is launched, it routinely shows the digicam view for reside textual content. When textual content is detected, customers can faucet the textual content to seize it. The scanned textual content is displayed within the decrease a part of the display.
Assuming you’ve created an ordinary SwiftUI challenge, open ContentView.swift
and the VisionKit
framework.
Subsequent, declare a few state variables to regulate the operation of the info scanner and the scanned textual content.
@State non-public var startScanning = false @State non-public var scanText = “” |
For the physique
half, let’s replace the code like this:
Textual content(scanText)
.body(minWidth: 0, maxWidth: .infinity, maxHeight: .infinity)
.background(in: Rectangle())
.backgroundStyle(Colour(uiColor: .systemGray6))
}
.job {
if DataScannerViewController.isSupported && DataScannerViewController.isAvailable {
startScanning.toggle()
}
}
VStack(spacing: 0) { DataScanner(startScanning: $startScanning, scanText: $scanText) .body(top: 400)
Textual content(scanText) .body(minWidth: 0, maxWidth: .infinity, maxHeight: .infinity) .background(in: Rectangle()) .backgroundStyle(Colour(uiColor: .systemGray6))
} .job { if DataScannerViewController.isSupported && DataScannerViewController.isAvailable { startScanning.toggle() } } |
We begin the info scanner when the app launches. However earlier than that, we name DataScannerViewController.isSupported
and DataScannerViewController.isAvailable
to make sure Stay Textual content is supported on the machine.
The demo app is nearly prepared to check. Since Stay Textual content requires Digicam entry, please bear in mind to go to the challenge configuration. Add the important thing Privateness – Digicam Utilization Description within the Information.plist
file and specify the explanation why your app must entry the machine’s digicam.
After the modifications, you possibly can deploy the app to an actual iOS machine and check the Stay Textual content perform.
Aside from English, Stay Textual content additionally helps French, Italian, German, Spanish, Chinese language, Portuguese, Japanese, and Korean.
For the supply code of this demo challenge, you possibly can test it out on GitHub.
Observe: We’re updating our Mastering SwiftUI guide for iOS 16. If you wish to begin studying SwiftUI, try the guide right here. You’ll obtain a free replace later this yr.