찾다

집 >웹 프론트엔드 >JS 튜토리얼 >문서 스캔을 위해 .NET MAUI Blazor에서 WebView Control로 전환

문서 스캔을 위해 .NET MAUI Blazor에서 WebView Control로 전환

PHPz
PHPz원래의
2024-07-29 18:37:22839검색

.NET MAUI 개발에서 BlazorWebView와 WebView는 모두 웹 콘텐츠를 표시하는 데 사용되지만 서로 다른 용도로 사용되며 서로 다른 시나리오에 맞게 설계되었습니다. BlazorWebView는 .NET MAUI 애플리케이션에서 Blazor 구성 요소를 호스팅하도록 특별히 설계되었으므로 Blazor 구성 요소를 재사용하고 웹 애플리케이션과 기본 애플리케이션 간에 코드를 공유할 수 있습니다. WebView는 웹 페이지, HTML 문자열 및 로컬 HTML 파일을 포함한 웹 콘텐츠를 표시하기 위한 범용 컨트롤입니다. 이 기사에서는 WebView 컨트롤을 사용하여 .NET MAUI Blazor 문서 스캐너 애플리케이션을 .NET MAUI 애플리케이션으로 전환하고, JavaScript 및 HTML로 문서 검색 논리를 구현하고, C#과 JavaScript 간의 상호 운용을 활성화하여 문서를 스캔하고 이미지를 저장하세요.

전제조건

  1. Dynamsoft 서비스 설치: 이 서비스는 Windows 및 macOS에서 TWAIN, SANE, ICA, ESCL 및 WIA 스캐너와 통신하는 데 필요합니다.
    • Windows: Dynamsoft-Service-Setup.msi
    • macOS: Dynamsoft-Service-Setup.pkg
  2. 무료 평가판 라이센스 요청: 시작하려면 Dynamic Web TWAIN에 대한 30일 무료 평가판 라이센스를 받으세요.

1단계: WebView 컨트롤을 사용하여 새 .NET MAUI 프로젝트 생성

  1. Visual Studio 또는 Visual Studio Code에서 새 .NET MAUI 프로젝트를 만듭니다.

  2. MainPage.xaml 파일을 열고 기존 코드를 다음 XAML로 바꿔 WebView 컨트롤을 추가합니다.

    <?xml version="1.0" encoding="utf-8" ?>
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="MauiWebView.MainPage">

    <ScrollView>
        <StackLayout
            VerticalOptions="FillAndExpand"
HorizontalOptions="FillAndExpand">
            <WebView
    x:Name="WebView"
    VerticalOptions="FillAndExpand"
    HorizontalOptions="FillAndExpand" Navigating="OnWebViewNavigated"/>

        </StackLayout>
    </ScrollView>

</ContentPage>

  3. MainPage.xaml.cs 파일을 열고 다음 코드를 추가하여 WebView의 소스를 설정하고 Navigating 이벤트를 처리합니다.

    namespace MauiWebView
{
    public partial class MainPage : ContentPage
    {
        public MainPage()
        {
            InitializeComponent();
            LoadHtmlFile();
        }

        private void LoadHtmlFile()
        {
            WebView.Source = "index.html";

        }

        private async void OnWebViewNavigated(object sender, WebNavigatingEventArgs e)
        {
            if (e.Url.StartsWith("invoke://callcsharpfunction"))
            {
                // TODO: Implement interop between C# and JavaScript
            }
        }
    }

}

    설명:

    • LoadHtmlFile 메서드는 WebView 컨트롤의 Source 속성을 설정하여 index.html 파일을 로드합니다.
    • OnWebViewNavigated 메서드는 WebView가 새 URL로 이동할 때 트리거됩니다. URL이 Invoke://callcsharpfunction으로 시작하는지 확인하고, 그렇다면 C# 및 JavaScript 상호 운용성을 허용합니다.

2단계: 정적 HTML, JavaScript 및 CSS 파일을 WebView 컨트롤에 로드

.NET MAUI 프로젝트에서는 Resources/Raw 폴더에 있는 정적 HTML, JavaScript 및 CSS 파일을 WebView로 로드할 수 있습니다. MauiAsset 빌드 작업이 .csproj 파일에 포함되어 있는지 확인하세요.

d0fd252dd0536d593a865b1b7d180310
    a6b6999ef84f0df9dca4c12a06340421
6e5ad26193226e804779ce3cd902f2c9

Switching from .NET MAUI Blazor to WebView Control for Document Scanning

index.html 파일에 이전 Blazor 문서 스캐너 애플리케이션과 유사한 UI 레이아웃을 만듭니다.

8b05045a5be5764f313ed5b9168a17e6
49099650ebdc5f3125501fa170048923

93f0f5c25f18dab9d176bd4f6de5d30e
    1fc2df4564f5324148703df3b6ed50c1
    4f2fb0231f24e8aef524fc9bf9b9874f

    b2386ffb911b14667cb8f0f91ea547a7Dynamsoft RESTful API Example6e916e0f7d1e588d4f442bf645aedb2f
    ea507197563fe9808580cd58ff5dae83
9c3bca370b5104690d9ef395f2c5f8d1

6c04bd5ca3fcae76e30b72ad730ca86d
    38b885ab7897934b555c67b94cd711e2
        0a6bb94971119ee328f517322c66980c16b28748ea4df4d9c2150843fecfba68
    16b28748ea4df4d9c2150843fecfba68

    c1a436a314ed609750bd7c7d319db4daDocument Scanner2e9b454fa8428549ca2e64dfac4625cd
    39bbc163833ae4e036fa5108a4263823
        dc6dce4a544fdca2df29d5ac0ea9906b
            2e1cf0710519d5598b1f0f14c36ba674
                Get a License key from e854f899d6c08fe1c619c9c20acd0fd7here5db79b134e9f6b82c0b36e0489ee08ed.
            8c1ecd4bb896b2264e0711597d40766c
            1a7f7aaa14e20835a1a1338a7058be2a
            df250b2156c434f3390392d09b1c9563
        16b28748ea4df4d9c2150843fecfba68

    16b28748ea4df4d9c2150843fecfba68

    4883ec0eb33c31828b7c767c806e14c7
        b91e30dda1382ac7285aae3f45407cef
            684271ed9684bde649abda8831d4d355Acquire Image39528cedfa926ea0c01e69ef5b2ea9b0
            b6f796d82ff1b4e710c079542e89e182Get Devices65281c5ac262bf6d81768915a4a77ac0

            dc6dce4a544fdca2df29d5ac0ea9906b
                6870baf322929e763a5a4dd5b95638a2Source: 8c1ecd4bb896b2264e0711597d40766c
                4e4da74db0fbe784cd1a8c486f2d663a18bb6ffaf0152bbe49cd8a3620346341
            16b28748ea4df4d9c2150843fecfba68

            dc6dce4a544fdca2df29d5ac0ea9906b
                5d63dc371f715490ca7f6d2e4600ec66Pixel Type: 8c1ecd4bb896b2264e0711597d40766c
                5eeb331c51742deae3114e4956cc1be1
                    5a07473c87748fb1bf73f23d45547ab8B &amp; W4afa15d3069109ac30911f04c56f3338
                    5a07473c87748fb1bf73f23d45547ab8Gray4afa15d3069109ac30911f04c56f3338
                    5a07473c87748fb1bf73f23d45547ab8Color4afa15d3069109ac30911f04c56f3338
                18bb6ffaf0152bbe49cd8a3620346341
            16b28748ea4df4d9c2150843fecfba68

            dc6dce4a544fdca2df29d5ac0ea9906b
                045b2ead8e25645fdd0c39f585f1e5bfResolution: 8c1ecd4bb896b2264e0711597d40766c
                c0e226d2d22b2a84209a20e9fa5db602
                    5a07473c87748fb1bf73f23d45547ab81004afa15d3069109ac30911f04c56f3338
                    5a07473c87748fb1bf73f23d45547ab81504afa15d3069109ac30911f04c56f3338
                    5a07473c87748fb1bf73f23d45547ab82004afa15d3069109ac30911f04c56f3338
                    5a07473c87748fb1bf73f23d45547ab83004afa15d3069109ac30911f04c56f3338
                18bb6ffaf0152bbe49cd8a3620346341
            16b28748ea4df4d9c2150843fecfba68


            dc6dce4a544fdca2df29d5ac0ea9906b
                1ee9335f254f79d03a6febbcf5d3d46b
                2c55b6d296473c35276f4ed5dfe2cf7dShow UI8c1ecd4bb896b2264e0711597d40766c
            16b28748ea4df4d9c2150843fecfba68
            dc6dce4a544fdca2df29d5ac0ea9906b
                5ebf17639bf6105e4664ab2e1fb1f6eb
                07c2649bd6a78c967126bb66652d154bADF8c1ecd4bb896b2264e0711597d40766c
            16b28748ea4df4d9c2150843fecfba68
            dc6dce4a544fdca2df29d5ac0ea9906b
                44173729fcd0e865b8455eb3701b40b7
                9fb9d3e7b5ec672c901c914afe880bd9Duplex8c1ecd4bb896b2264e0711597d40766c
            16b28748ea4df4d9c2150843fecfba68

            ebf9f28c318eafce2dd4c8e1bb2c253cScan Now65281c5ac262bf6d81768915a4a77ac0
            6d9fd183d333544e9d5fe06824808c81Save65281c5ac262bf6d81768915a4a77ac0

            684271ed9684bde649abda8831d4d355Image Tools39528cedfa926ea0c01e69ef5b2ea9b0
            2326325328cfb1510e6119c7566a1325
                679019de3d0cfbcca4676917ab8cd4f0
                    803a9dc7ffbcccf77de190935b40089a
                65281c5ac262bf6d81768915a4a77ac0
                becd6db3ab50097bcb2036771f348f01
                    b411ae39fbc39f0429a39ad945dcd511
                65281c5ac262bf6d81768915a4a77ac0
                c56962c63fec7fa8fb3820e921cf15bf
                    b02f8f3397f265cf44c9fcab016cc9c7
                65281c5ac262bf6d81768915a4a77ac0
            16b28748ea4df4d9c2150843fecfba68
        16b28748ea4df4d9c2150843fecfba68

        b3be3238529c3d77b69b7fd150fd938b
            46c5d3aad1e47bee946e6355bc5143b4
                ec6b4fd79f2415f29f0b734dcd571fb5
            16b28748ea4df4d9c2150843fecfba68

            39bbc163833ae4e036fa5108a4263823
                b7c1222a61bcb1861cf5c6bfedb3b7cd
                    a1e9e9b21d1fae6be88debb6fb09c6cc 
                    16b28748ea4df4d9c2150843fecfba68
                16b28748ea4df4d9c2150843fecfba68
            16b28748ea4df4d9c2150843fecfba68
        16b28748ea4df4d9c2150843fecfba68
    16b28748ea4df4d9c2150843fecfba68

    e803653d6fd93b3996ebf69dd59af1622cacc6d41bbb37262a98f745aa00fbf0
36cc49f0c466276486e50c850b7e4956

73a6ac4ed44ffec12cee46588e518a5e

3단계: JavaScript로 문서 스캔 구현

환경이 준비되었으면 다음 단계는 관련 기능을 JavaScript로 구현하는 것입니다.

장치 가져오기

사용 가능한 스캐너를 열거하세요.

const ScannerType = {
    // TWAIN scanner type, represented by the value 0x10
    TWAINSCANNER: 0x10,

    // WIA scanner type, represented by the value 0x20
    WIASCANNER: 0x20,

    // 64-bit TWAIN scanner type, represented by the value 0x40
    TWAINX64SCANNER: 0x40,

    // ICA scanner type, represented by the value 0x80
    ICASCANNER: 0x80,

    // SANE scanner type, represented by the value 0x100
    SANESCANNER: 0x100,

    // eSCL scanner type, represented by the value 0x200
    ESCLSCANNER: 0x200,

    // WiFi Direct scanner type, represented by the value 0x400
    WIFIDIRECTSCANNER: 0x400,

    // WIA-TWAIN scanner type, represented by the value 0x800
    WIATWAINSCANNER: 0x800
};

let queryDevicesButton = document.getElementById("query-devices-button");
queryDevicesButton.onclick = async () => {
    let scannerType = ScannerType.TWAINSCANNER | ScannerType.TWAINX64SCANNER;
    let devices = await getDevices(host, scannerType);
    let select = document.getElementById("sources");
    select.innerHTML = '';
    for (let i = 0; i f880fbe9c9baf97c4ce8ef91b2b09a79 {
    let select = document.getElementById("sources");
    let device = select.value;

    if (device == null || device.length == 0) {
        alert('Please select a scanner.');
        return;
    }

    let inputText = document.getElementById("inputText").value;
    let license = inputText.trim();

    if (license == null || license.length == 0) {
        alert('Please input a valid license key.');
    }

    let parameters = {
        license: license,
        device: JSON.parse(device)['device'],
    };

    let showUICheck = document.getElementById("showUICheckId");

    let pixelTypeSelect = document.getElementById("pixelTypeSelectId");

    let resolutionSelect = document.getElementById("resolutionSelectId");

    let adfCheck = document.getElementById("adfCheckId");

    let duplexCheck = document.getElementById("duplexCheckId");

    parameters.config = {
        IfShowUI: showUICheck.checked,
        PixelType: pixelTypeSelect.selectedIndex,
        Resolution: parseInt(resolutionSelect.value),
        IfFeederEnabled: adfCheck.checked,
        IfDuplexEnabled: duplexCheck.checked,
    };


    let jobId = await scanDocument(host, parameters);
    let images = await getImages(host, jobId);

    for (let i = 0; i 30f38ec796a9a4f3b797e10c6aa42e38 {
                if (e != null && e.target != null) {
                    let target = e.target;
                    img.src = target.src;
                    selectedThumbnail = target;
                }
            });
        }

        selectedThumbnail = newImage;
    }

}

async function scanDocument(host, parameters, timeout = 30) {
    let url = host + '/DWTAPI/ScanJobs?timeout=' + timeout;

    try {
        let response = await fetch(url, {
            method: 'POST',
            headers: {
                'Content-Type': 'application/json'
            },
            body: JSON.stringify(parameters)
        });

        if (response.ok) {
            let jobId = await response.text();
            return jobId;
        }
        else {
            return '';
        }
    } catch (error) {
        alert(error);
        return '';
    }
}

async function getImages(host, jobId) {
    let images = [];
    let url = host + '/DWTAPI/ScanJobs/' + jobId + '/NextDocument';

    while (true) {
        try {

            let response = await fetch(url);

            if (response.status == 200) {
                const arrayBuffer = await response.arrayBuffer();
                const blob = new Blob([arrayBuffer], { type: response.type });
                const imageUrl = URL.createObjectURL(blob);

                images.push(imageUrl);
            }
            else {
                break;
            }

        } catch (error) {
            console.error('No more images.');
            break;
        }
    }

    return images;
}

설명

  • scanDocument 함수는 RESTful API 엔드포인트 /DWTAPI/ScanJobs에 POST 요청을 보내 스캔 작업을 시작합니다. 매개변수에는 라이센스 키, 장치 이름, 스캔 설정이 포함됩니다.
  • getImages 함수는 스캔된 이미지를 가져오기 위해 RESTful API 엔드포인트 /DWTAPI/ScanJobs/{jobId}/NextDocument에 GET 요청을 보냅니다. 이미지는 Blob 개체에 저장되고 이미지 표시 영역에 표시됩니다.

이미지 회전

스캔 이미지를 -90도 또는 90도 회전합니다.

let rotateLeftButton = document.getElementById("rotate-left-button");
rotateLeftButton.onclick = () => {
    let img = document.getElementById('document-image');
    img.src = rotateImage('document-image', -90);
    selectedThumbnail.src = img.src;
}

let rotateRightButton = document.getElementById("rotate-right-button");
rotateRightButton.onclick = () => {
    let img = document.getElementById('document-image');
    img.src = rotateImage('document-image', 90);
    selectedThumbnail.src = img.src;
}

    function rotateImage (imageId, angle) {
    const image = document.getElementById(imageId);
    const canvas = document.createElement('canvas');
    const context = canvas.getContext('2d');
    const imageWidth = image.naturalWidth;
    const imageHeight = image.naturalHeight;

    // Calculate the new rotation
    let rotation = 0;
    rotation = (rotation + angle) % 360;

    // Adjust canvas size for rotation
    if (rotation === 90 || rotation === -270 || rotation === 270) {
        canvas.width = imageHeight;
        canvas.height = imageWidth;
    } else if (rotation === 180 || rotation === -180) {
        canvas.width = imageWidth;
        canvas.height = imageHeight;
    } else if (rotation === 270 || rotation === -90) {
        canvas.width = imageHeight;
        canvas.height = imageWidth;
    } else {
        canvas.width = imageWidth;
        canvas.height = imageHeight;
    }

    // Clear the canvas
    context.clearRect(0, 0, canvas.width, canvas.height);

    // Draw the rotated image on the canvas
    context.save();
    if (rotation === 90 || rotation === -270) {
        context.translate(canvas.width, 0);
        context.rotate(90 * Math.PI / 180);
    } else if (rotation === 180 || rotation === -180) {
        context.translate(canvas.width, canvas.height);
        context.rotate(180 * Math.PI / 180);
    } else if (rotation === 270 || rotation === -90) {
        context.translate(0, canvas.height);
        context.rotate(270 * Math.PI / 180);
    }
    context.drawImage(image, 0, 0);
    context.restore();

    return canvas.toDataURL();
}

이미지 삭제

메인 이미지와 썸네일을 포함한 모든 스캔 이미지를 삭제하고 데이터 배열을 재설정하세요.

let deleteButton = document.getElementById("delete-button");
deleteButton.onclick = async () => {
    let img = document.getElementById('document-image');
    img.src = 'images/default.png';
    data = [];
    let thumbnails = document.getElementById("thumb-box");
    thumbnails.innerHTML = '';
}

4단계: 이미지 저장을 위한 C#과 JavaScript 간의 상호 운용성

보안 문제로 인해 JavaScript에 이미지를 직접 저장하는 것은 제한됩니다. 따라서 이 작업을 수행하려면 C#과 JavaScript 간의 상호 운용이 필요합니다.

  1. 스캔 이미지를 base64 문자열로 변환하는 JavaScript 함수를 만듭니다.

    function getBase64Image() {
    var img = document.getElementById('document-image');
    var canvas = document.createElement('canvas');
    canvas.width = img.naturalWidth;
    canvas.height = img.naturalHeight;
    var ctx = canvas.getContext('2d');
    ctx.drawImage(img, 0, 0);

    var dataURL = canvas.toDataURL('image/png'); 
    var base64 = dataURL.split(',')[1]; 
    return base64;
}

  2. 저장 버튼을 클릭할 때 WebView 컨트롤의 OnWebViewNavigated 이벤트 핸들러를 트리거하도록 window.location.href를 설정하세요.

    let saveButton = document.getElementById("save-button");
saveButton.onclick = async () => {
    window.location.href = 'invoke://CallCSharpFunction';    
}

  3. OnWebViewNavigated 이벤트 핸들러에서 EvaluateJavaScriptAsync를 호출하여 JavaScript에서 base64 이미지 데이터를 검색하고 파일에 저장합니다.

    private async void OnWebViewNavigated(object sender, WebNavigatingEventArgs e)
{
    if (e.Url.StartsWith("invoke://callcsharpfunction"))
    {
        var base64String = await WebView.EvaluateJavaScriptAsync("getBase64Image()");
        CallCSharpFunction(base64String);
    }
}

private void CallCSharpFunction(string base64String)
{
    if (!string.IsNullOrEmpty(base64String))
    {

        try
        {
            byte[] imageBytes = Convert.FromBase64String(base64String);

            var filePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments), GenerateFilename());
            File.WriteAllBytes(filePath, imageBytes);
            DisplayAlert("Success", "Image saved to: " + filePath, "OK");

        }
        catch (Exception ex)
        {
            DisplayAlert("Error", ex.Message, "OK");
        }
    }
    else
    {
        DisplayAlert("Failure", "No image data found", "OK");
    }
}

private string GenerateFilename()
{
    DateTime now = DateTime.Now;
    string timestamp = now.ToString("yyyyMMdd_HHmmss");
    return $"image_{timestamp}.png";
}

Note: Do not pass the base64 string directly to the C# function via window.location.href, as the string may be too long and cause an error. Instead, return the base64 string when calling EvaluateJavaScriptAsync from the C# function.

Step 5: Run the .NET MAUI Document Scanner Application

Press F5 in Visual Studio or Visual Studio Code to run the .NET document scanner application on Windows or macOS.

Switching from .NET MAUI Blazor to WebView Control for Document Scanning

Source Code

https://github.com/yushulx/dotnet-twain-wia-sane-scanner/tree/main/examples/MauiWebView

위 내용은 문서 스캔을 위해 .NET MAUI Blazor에서 WebView Control로 전환의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!

JavaScript restful css html Static String Array Object if for include Error using Property Event delete function this location href display transition github windows visual studio macos visual studio code webview https ui
성명：
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
이전 기사：코드 주간 5다음 기사：코드 주간 5

관련 기사

더보기