PHP Web应用集成SecuGen Hamster Plus HSDU03P：指纹显示问题求助

Hey there, let's work through getting your SecuGen Hamster Plus integrated with your web app and fix that broken ActiveX example code. I'll break this down into actionable steps and a simplified working demo to get you up and running.

First, Let's Diagnose the Core Issues #

ActiveX-based scanner integration is finicky, especially on modern Windows/IE setups. Here are the most common roadblocks you're likely hitting:

• ActiveX only works in Internet Explorer (or Edge's IE Compatibility Mode)—Chrome/Firefox don't support it at all.
• The ActiveX control might not be properly registered on your system.
• IE's default security settings block unsigned ActiveX controls from running.
• Your example code might have incorrect class names or missing error handling.

Step 1: Validate Prerequisites #

Before touching code, confirm these basics:

• Driver/API Installation: Open Device Manager and ensure the SecuGen Hamster Plus shows up under "Biometric Devices" with no yellow exclamation marks. Run the SDK's built-in test tool (like SGDemo.exe from the SDK folder) to confirm you can scan fingerprints there—this rules out hardware/driver issues.
• Browser Compatibility: Launch Internet Explorer (not Edge unless you enable IE mode) for testing.

Step 2: Register the ActiveX Control #

The SDK's OCX file needs to be registered with Windows. Here's how:

1. Find the OCX file in your SecuGen SDK installation directory (usually something like C:\Program Files\SecuGen\FDx Pro SDK\Bin\SGXFPPro.ocx).
2. Right-click Command Prompt and select Run as Administrator.
3. Run this command (replace the path with your actual OCX location):

   regsvr32 "C:\Program Files\SecuGen\FDx Pro SDK\Bin\SGXFPPro.ocx"
   

4. You should see a "DllRegisterServer in SGXFPPro.ocx succeeded" message. If not, double-check the path and admin rights.

Step 3: Adjust IE Security Settings #

IE blocks unsigned ActiveX by default. For testing, loosen these settings temporarily:

1. Open IE → Go to Tools > Internet Options > Security > Custom Level.
2. Under "ActiveX controls and plugins":
   • Enable "Initialize and script ActiveX controls not marked as safe for scripting" (only for testing—lock this down in production).
   • Enable "Download unsigned ActiveX controls" (again, test-only).
3. Click OK and restart IE.

Step 4: Working Demo Code #

Here's a simplified, error-handled version of the code that will capture a fingerprint template and display it as a hex string in your input box:

<html>
<head>
    <title>SecuGen Hamster Plus Web Demo</title>
    <script language="javascript">
        let fpScanner;

        // Initialize scanner on page load
        function initScanner() {
            try {
                // Create ActiveX object (class name matches SecuGen's SDK)
                fpScanner = new ActiveXObject("SecuGen.FDxProSDK");
                
                // Initialize the scanner (0 = default device)
                const initResult = fpScanner.InitDevice(0);
                if (initResult !== 0) {
                    alert(`Failed to start scanner. Error code: ${initResult}`);
                    return;
                }
                alert("Scanner ready! Click 'Scan Fingerprint' to capture.");
            } catch (e) {
                alert(`Error initializing scanner: ${e.message}\nCheck if ActiveX is registered and IE settings allow it.`);
            }
        }

        // Capture fingerprint and display in input box
        function scanFingerprint() {
            if (!fpScanner) {
                alert("Scanner not initialized! Refresh the page and try again.");
                return;
            }

            try {
                const fpTemplate = [];
                const captureResult = fpScanner.CaptureFinger(fpTemplate);
                
                if (captureResult === 0) {
                    // Convert template array to hex string for display
                    const hexString = arrayToHex(fpTemplate);
                    document.getElementById("fingerprintInput").value = hexString;
                } else {
                    alert(`Failed to capture fingerprint. Error code: ${captureResult}`);
                }
            } catch (e) {
                alert(`Error during scan: ${e.message}`);
            }
        }

        // Helper: Convert byte array to hex string
        function arrayToHex(arr) {
            let hex = "";
            for (const byte of arr) {
                const hexByte = byte.toString(16).padStart(2, "0");
                hex += hexByte.toUpperCase();
            }
            return hex;
        }
    </script>
</head>
<body onload="initScanner()">
    <h2>SecuGen Hamster Plus Fingerprint Capture</h2>
    <input type="text" id="fingerprintInput" size="100" placeholder="Scanned fingerprint data will appear here">
    <br><br>
    <button onclick="scanFingerprint()">Scan Fingerprint</button>
</body>
</html>

Step 5: Troubleshooting Remaining Issues #

If it still doesn't work:

• Check Error Codes: The SDK returns numeric error codes (e.g., 1 = device not found, 5 = invalid parameter). Look up these codes in the SDK's documentation to pinpoint the issue.
• Verify ActiveX Class Name: If SecuGen.FDxProSDK doesn't work, check the SDK's docs for the correct ProgID (sometimes it's SGXFPPro.SGXFPProCtrl).
• Test in IE Compatibility Mode: If you're using Edge, go to Settings > Default browser > Allow sites to be reloaded in Internet Explorer mode and add your test page.

内容的提问来源于stack exchange，提问作者Jeph danso