Panduan pengidentifikasi teks

Tutorial singkat ini menjelaskan fungsionalitas pengenalan teks yang disertakan dalam sampel WINDOWS AI API untuk WinForms. Secara khusus, ini menunjukkan cara menggunakan WINDOWS AI API untuk melakukan pengenalan teks pada gambar dan meringkas teks yang dikenali.

Prasyarat

Untuk mempelajari tentang persyaratan perangkat keras Windows AI API dan cara mengonfigurasi perangkat Anda agar berhasil membuat aplikasi menggunakan API Windows AI, lihat Mulai membuat aplikasi dengan API Windows AI.

Pendahuluan

Kelas MainForm di MainForm.cs adalah antarmuka pengguna utama untuk aplikasi sampel Windows AI API yang mengimplementasikan fungsionalitas berikut:

  • Pilih File: Memungkinkan pengguna memilih file gambar dari sistem file mereka dan menampilkan gambar tersebut di PictureBox.
  • Gambar Proses: Memproses gambar yang dipilih untuk mengekstrak teks menggunakan Pengenalan Karakter Optik (OCR) lalu meringkas teks yang diekstrak.

Fungsi utama dan penanganan aktivitas

Beberapa fungsi dan penanganan aktivitas yang lebih signifikan dalam sampel Windows AI API untuk WinForms meliputi yang berikut:

  • SelectFile_Click: Membuka dialog file bagi pengguna untuk memilih file gambar dan menampilkan gambar yang dipilih.
  • ProcessButton_Click: Menangani pemrosesan gambar yang dipilih, termasuk memuat model AI, melakukan pengenalan teks, dan meringkas teks.
  • LoadAIModels: Memuat model AI yang diperlukan (TextRecognizer dan LanguageModel) untuk pengenalan dan ringkasan teks.
  • PerformTextRecognition: Menggunakan TextRecognizer untuk melakukan OCR pada gambar yang dipilih dan mengekstrak teks. Fungsi ini disertakan dalam contoh Pengenalan teks berikut.
  • SummarizeImageText: Menggunakan LanguageModel untuk menghasilkan ringkasan dari teks yang diekstrak berdasarkan petunjuk yang diberikan.

Contoh pengenalan teks

Fungsi PerformTextRecognition dalam contoh ini

Gambar masukan.

Aplikasi sampel yang diinisialisasi.

private async Task<string> PerformTextRecognition()
{
    using TextRecognizer textRecognizer = await TextRecognizer.CreateAsync();
    ImageBuffer? imageBuffer = await LoadImageBufferFromFileAsync(pathToImage);

    if (imageBuffer == null)
    {
        throw new Exception("Failed to load image buffer.");
    }

    RecognizedText recognizedText = 
        textRecognizer!.RecognizeTextFromImage(imageBuffer);

    var recognizedTextLines = recognizedText.Lines.Select(line => line.Text);
    string text = string.Join(Environment.NewLine, recognizedTextLines);

    richTextBoxForImageText.Text = text;
    return text;
}

Contoh aplikasi setelah menangkap teks gambar (ditampilkan di kotak kiri bawah) dan meringkas teks gambar (ditampilkan di kotak kanan bawah).

Bangun dan jalankan sampel

  1. Klon repositori WindowsAppSDK-Samples.
  2. Beralih ke branch "release/experimental".
  3. Navigasikan ke folder Samples/WindowsAIFoundry/cs-winforms-pckg .
  4. Buka WindowsAISample.sln di Visual Studio 2022.
  5. Ubah Platform Solusi agar sesuai dengan arsitektur perangkat Anda (ARM64 untuk Copilot+ PCs, x64 untuk perangkat Intel/AMD).
  6. Klik kanan pada solusi di Penjelajah Solusi dan pilih "Bangun" untuk membangun solusi.
  7. Setelah build berhasil, klik kanan proyek di Penjelajah Solusi dan pilih "Atur sebagai Proyek Startup".
  8. Tekan F5 atau pilih "Mulai Penelusuran Kesalahan" dari menu Debug untuk menjalankan contoh uji coba (contoh uji coba juga dapat dijalankan tanpa penelusuran kesalahan dengan memilih "Mulai Tanpa Penelusuran Kesalahan" dari menu Debug atau Ctrl+F5).

Lihat juga