Tutorial: Membuat aplikasi iOS yang meluncurkan Immersive Reader dengan konten dari foto (Swift)

Immersive Reader adalah alat yang dirancang secara inklusif yang menerapkan teknik yang terbukti untuk meningkatkan pemahaman membaca.

Computer Vision Cognitive Services Read API mendeteksi konten teks dalam gambar menggunakan model pengenalan terbaru Microsoft dan mengonversi teks yang diidentifikasi menjadi stream karakter yang dapat dibaca mesin.

Dalam tutorial ini, Anda akan membangun aplikasi iOS dari awal dan mengintegrasikan Read API, dan Immersive Reader dengan menggunakan Immersive Reader SDK. Sampel lengkap dari mulai cepat ini tersedia di sini.

Jika Anda tidak memiliki langganan Azure, buat akun gratis sebelum Anda memulai.

Prasyarat

  • Xcode
  • Sumber daya Immersive Reader dikonfigurasi untuk autentikasi Azure Active Directory. Ikuti petunjuk ini untuk menyiapkannya. Anda akan memerlukan beberapa nilai yang dibuat di sini saat mengonfigurasikan properti proyek sampel. Simpan output sesi Anda ke dalam file teks untuk digunakan sebagai referensi di kemudian hari.
  • Penggunaan sampel ini memerlukan langganan Azure ke Cognitive Service Computer Vision. Buat sumber daya Cognitive Service Computer Vision di portal Microsoft Azure.

Buat proyek Xcode

Buat proyek baru di Xcode.

Proyek Baru

Pilih Aplikasi Tampilan Tunggal.

Aplikasi Tampilan Tunggal Baru

Dapatkan SDK CocoaPod

Cara termudah untuk menggunakan SDK Immersive Reader adalah melalui CocoaPods. Untuk memasang melalui Cocoapods:

  1. Pasang CocoaPods - Ikuti panduan memulai untuk memasang Cocoapods.
  2. Buat Podfile dengan menjalankan pod init di direktori root proyek Xcode Anda.
  3. Tambahkan CocoaPod ke Podfile Anda dengan menambahkan pod 'immersive-reader-sdk', :path => 'https://github.com/microsoft/immersive-reader-sdk/tree/master/iOS/immersive-reader-sdk'. Podfile Anda akan terlihat seperti berikut ini, dengan nama target Anda mengganti picture-to-immersive-reader-swift:
 platform :ios, '9.0'

 target 'picture-to-immersive-reader-swift' do
 use_frameworks!
 # Pods for picture-to-immersive-reader-swift
 pod 'immersive-reader-sdk', :git => 'https://github.com/microsoft/immersive-reader-sdk.git'
 end
  1. Di terminal, di direktori proyek Xcode Anda, jalankan perintah pod install untuk memasang Pod SDK Immersive Reader.
  2. Tambahkan import immersive_reader_sdk ke semua file yang perlu mereferensikan SDK.
  3. Pastikan untuk membuka proyek dengan membuka file .xcworkspace dan bukan file .xcodeproj.

Memperoleh token autentikasi Microsoft Azure Active Directory

Anda memerlukan beberapa nilai dari prasyarat konfigurasi autentikasi Microsoft Azure Active Directory di atas untuk bagian ini. Lihat kembali ke file teks yang Anda simpan dari sesi tersebut.

TenantId     => Azure subscription TenantId
ClientId     => Azure AD ApplicationId
ClientSecret => Azure AD Application Service Principal password
Subdomain    => Immersive Reader resource subdomain (resource 'Name' if the resource was created in the Azure portal, or 'CustomSubDomain' option if the resource was created with Azure CLI Powershell. Check the Azure portal for the subdomain on the Endpoint in the resource Overview page, for example, 'https://[SUBDOMAIN].cognitiveservices.azure.com/')

Di folder proyek utama, yang berisi file ViewController.swift, buat file kelas Swift yang disebut Constants.swift. Ganti kelas dengan kode berikut, tambahkan nilai Anda jika berlaku. Simpan berkas ini sebagai file lokal yang hanya ada pada mesin Anda dan pastikan untuk tidak menerapkan file ini ke dalam kontrol sumber, karena memuat rahasia yang seharusnya tidak dipublikasikan. Disarankan agar Anda tidak menyimpan rahasia di aplikasi Anda. Sebaliknya, kami sarankan menggunakan layanan backend untuk mendapatkan token, tempat rahasia dapat disimpan di luar aplikasi dan di luar perangkat. Titik akhir API backend harus diamankan di balik beberapa bentuk autentikasi (misalnya, OAuth) untuk mencegah pengguna yang tidak diotorisasi mendapatkan token untuk digunakan terhadap layanan dan penagihan Immersive Reader Anda; pekerjaan itu di luar cakupan tutorial ini.

Menyiapkan aplikasi untuk dijalankan tanpa papan cerita

Buka AppDelegate.swift dan ganti file dengan kode berikut.

Menambahkan fungsionalitas untuk mengambil dan mengunggah foto

Ganti Nama ViewController.swift ke PictureLaunchViewController.swift dan ganti file dengan kode berikut.

Membuat dan menjalankan aplikasi

Atur skema arsip di Xcode dengan memilih simulator atau target perangkat. Skema arsip
Memilih Target

Di Xcode, tekan Ctrl + R atau klik tombol putar untuk menjalankan proyek dan aplikasi harus diluncurkan pada simulator atau perangkat yang ditentukan.

Di aplikasi, Anda akan melihat:

Aplikasi sampel

Di dalam aplikasi, ambil atau unggah foto teks dengan menekan tombol 'Ambil Foto' atau tombol 'Pilih Foto dari Pustaka' dan Immersive Reader kemudian akan meluncurkan menampilkan teks dari foto.

Pembaca Imersif

Langkah berikutnya