Inktgegevens naar de Ink Recognizer-API verzenden
Notitie
De preview van de Ink Recognizer-API is op 26 augustus 2020 beëindigd. Als u bestaande Ink Recognizer-resources hebt, kunt u die blijven gebruiken totdat de service volledig wordt beëindigd op 31 januari 2021.
Digital Inking verwijst naar technologieën die digitale representaties mogelijk maken van input zoals handgeschreven tekst en tekeningen. Dit wordt meestal bereikt met behulp van een digitaler waarmee de bewegingen van invoerapparaten, zoals een stylus, worden vastgelegd. Omdat apparaten rijke digitale inktwaarneming mogelijk maken, kunnen kunstmatige intelligentie en machine learning geschreven vormen en tekst in vrijwel elke context herkennen. Met de Ink Recognizer-API kunt u pennenstreken verzenden en gedetailleerde informatie over deze pennenstreken krijgen.
De Ink recognizer-API versus OCR-services
De Ink Recognizer-API maakt geen gebruik van Optical Character Recognition (OCR). OCR-services verwerken de pixelgegevens van afbeeldingen om handschrift en tekstherkenning te bieden. Dit wordt ook wel offlineherkenning genoemd. In plaats daarvan vereist de Ink Recognizer-API digitale pennenstreken die worden vastgelegd als het invoerapparaat wordt gebruikt. Het verwerken van digitale inktgegevens kan op deze manier nauwkeurigere herkenningsresultaten opleveren in vergelijking met OCR-services.
Inktgegevens verzenden
De Ink Recognizer-API vereist de X- en Y-coördinaten die de pennenstreken vertegenwoordigen die zijn gemaakt door een invoerapparaat, vanaf het moment dat het detectieoppervlak aanraakt tot wanneer het wordt opgeheven. De punten van elke lijn moeten een tekenreeks met door komma's gescheiden waarden zijn en worden opgemaakt in JSON, zoals in het onderstaande voorbeeld. Daarnaast moet elke pennenstreek een unieke id in elke aanvraag hebben. Als de id binnen dezelfde aanvraag wordt herhaald, retourneert de API een fout. Voor de meest nauwkeurige herkenningsresultaten moet u ten minste acht cijfers achter het decimaalteken hebben. De oorsprong (0,0) van het canvas wordt verondersteld de linkerbovenhoek van het inktcanvas te zijn.
Notitie
Het volgende voorbeeld is geen geldige JSON. U vindt een volledige Ink Recognizer JSON-aanvraag op GitHub.
{
"language": "en-US",
"strokes": [
{
"id": 43,
"points":
"5.1365, 12.3845,
4.9534, 12.1301,
4.8618, 12.1199,
4.7906, 12.2217,
4.7906, 12.5372,
4.8211, 12.9849,
4.9534, 13.6667,
5.0958, 14.4503,
5.3299, 15.2441,
5.6555, 16.0480,
..."
},
...
]
}
Antwoord van Ink Recognizer
De Ink Recognizer-API retourneert een analyseantwoord over de objecten die worden herkend vanuit de inktinhoud. Het antwoord bevat herkenningseenheden die de relaties tussen verschillende pennenstreken beschrijven. Stroken die afzonderlijke vormen maken, worden bijvoorbeeld in verschillende eenheden opgenomen. Elke eenheid bevat gedetailleerde informatie over de pennenstreken, waaronder het herkende object, de coördinaten en andere tekenkenmerken.
Shapes die worden herkend door de Ink Recognizer-API
Met de Ink Recognizer-API kunt u de meest gebruikte shapes identificeren bij het maken van notities. In de onderstaande afbeelding ziet u enkele basisvoorbeelden. Zie het API-referentieartikel voor een volledige lijst met shapes en andere inktinhoud die door de API wordt herkend.
Aanbevolen belpatronen
U kunt de Rest API van Ink Recognizer in verschillende patronen aanroepen op basis van uw toepassing.
Door de gebruiker geïnitieerde API-aanroepen
Als u een app bouwt die gebruikersinvoer gebruikt (bijvoorbeeld een app voor het maken van notities of aantekeningen), kunt u ze de controle geven over wanneer en welke inkt wordt verzonden naar de Ink Recognizer-API. Deze functionaliteit is vooral handig wanneer tekst en vormen beide aanwezig zijn op het canvas en gebruikers verschillende acties voor elk programma willen uitvoeren. Overweeg selectiefuncties (zoals een lasso of een ander geometrisch selectiehulpmiddel) toe te voegen waarmee gebruikers kunnen kiezen wat er naar de API wordt verzonden.
Door app geïnitieerde API-aanroepen
U kunt uw app ook de Ink Recognizer-API laten aanroepen na een time-out. Door de huidige pennenstreken regelmatig naar de API te verzenden, kunt u herkenningsresultaten opslaan terwijl ze worden gemaakt tijdens het verbeteren van de reactietijd van de API. U kunt bijvoorbeeld een regel handgeschreven tekst naar de API verzenden nadat de gebruiker deze heeft gedetecteerd.
Als u de herkenningsresultaten van tevoren hebt, krijgt u informatie over de kenmerken van pennenstreken wanneer ze met elkaar verband houden. Bijvoorbeeld, welke pennenstreken zijn gegroepeerd om hetzelfde woord, lijn, lijst, alinea of vorm te vormen. Met deze informatie kunt u de inktselectiefuncties van uw app verbeteren door bijvoorbeeld groepen pennenstreken tegelijk te selecteren.
De Ink Recognizer-API integreren met Windows Ink
Windows Ink biedt hulpprogramma's en technologieën om digitale inktervaringen op verschillende apparaten mogelijk te maken. U kunt het Windows Ink-platform combineren met de Ink Recognizer-API om toepassingen te maken die digitale pennenstreken weergeven en interpreteren.
Volgende stappen
Begin met het verzenden van gegevens over digitale pennenstreken met behulp van: