Skicka pennanteckning till API:et för handskriftsigenkänning

  • Artikel

Anteckning

API:et för handskriftsigenkänning har avslutat förhandsversionen den 26 augusti 2020. Om du har befintliga resurser för handskriftsigenkänning kan du fortsätta att använda dem tills tjänsten har dragits tillbaka helt den 31 januari 2021.

Digitala pennanteckningar avser teknik som möjliggör digitala representationer av indata, till exempel handskrift och ritningar. Detta uppnås vanligtvis med hjälp av en digitaliserare som samlar in förflyttningar av indataenheter, till exempel en penna. När enheter fortsätter att aktivera omfattande användning av digitala pennanteckningar kan artificiell intelligens och maskininlärning möjliggöra igenkänning av skriftliga former och text i en kontext. Med API:et för handskriftsigenkänning kan du skicka pennstreck och få detaljerad information om dem.

API:et för handskriftsigenkänning jämfört med OCR-tjänster

API:et för handskriftsigenkänning använder inte optisk teckenläsning (OCR). OCR-tjänster bearbetar pixeldata från bilder för att tillhandahålla handskrift och textigenkänning. Detta kallas ibland offlineigenkänning. I stället kräver API:et för handskriftsigenkänning digitala penndragsdata som samlas in när indataenheten används. Bearbetning av digitala pennanteckningar på det här sättet kan ge mer exakta igenkänningsresultat jämfört med OCR-tjänster.

Skicka pennanteckningsdata

API:et för handskriftsigenkänning kräver X- och Y-koordinaterna som representerar pennstrecken som skapats av en indataenhet, från det ögonblick det rör vid identifieringsytan tills det lyfts. Punkterna för varje linje måste vara en sträng med kommaavgränsade värden och formateras i JSON som i exemplet nedan. Dessutom måste varje pennstreck ha ett unikt ID i varje begäran. Om ID:t upprepas i samma begäran returnerar API:et ett fel. För de mest exakta igenkänningsresultaten har du minst åtta siffror efter decimaltecknet. Arbetsytans ursprung (0,0) antas vara det övre vänstra hörnet på arbetsytan.

Anteckning

Följande exempel är inte giltigt JSON. Du hittar en fullständig JSON-begäran för handskriftsigenkänning på 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,
        ..."
   },
    ...
  ]
}

Svar från handskriftsigenkänning

API:et för handskriftsigenkänning returnerar ett analyssvar om de objekt som identifieras från pennanteckningsinnehållet. Svaret innehåller igenkänningsenheter som beskriver relationerna mellan olika pennstreck. Till exempel kommer streck som skapar distinkta, separata former att finnas i olika enheter. Varje enhet innehåller detaljerad information om dess pennstreck, inklusive det identifierade objektet, dess koordinater och andra ritade attribut.

Former som identifieras av API:et för handskriftsigenkänning

API:et för handskriftsigenkänning kan identifiera de vanligaste formerna i anteckningen. Bilden nedan visar några grundläggande exempel. En fullständig lista över former och annat pennanteckningsinnehåll som identifieras av API:et finns i API-referensartikeln.

Listan över former som identifieras av API:et för handskriftsigenkänning

Du kan anropa REST-API:et för handskriftsigenkänning i olika mönster enligt ditt program.

Användarinitierade API-anrop

Om du skapar en app som tar användarindata (till exempel en antecknings- eller anteckningsapp) kanske du vill ge dem kontroll över när och vilka pennanteckningar som skickas till API:et för handskriftsigenkänning. Den här funktionen är särskilt användbar när både text och former finns på arbetsytan och användarna vill utföra olika åtgärder för var och en. Överväg att lägga till markeringsfunktioner (till exempel en lasso eller ett annat geometriskt urvalsverktyg) som gör det möjligt för användare att välja vad som skickas till API:et.

Appinitierade API-anrop

Du kan också låta din app anropa API:et för handskriftsigenkänning efter en timeout. Genom att skicka de aktuella pennstrecken till API:et rutinmässigt kan du lagra igenkänningsresultat när de skapas samtidigt som du förbättrar API:ets svarstid. Du kan till exempel skicka en rad med handskriven text till API:et när du har upptäckt att användaren har slutfört den.

Genom att ha igenkänningsresultaten i förväg får du information om egenskaperna hos pennstreck när de relaterar till varandra. Till exempel vilka linjer grupperas för att bilda samma ord, linje, lista, stycke eller form. Den här informationen kan förbättra appens pennmarkeringsfunktioner genom att till exempel välja grupper av pennstreck samtidigt.

Integrera API:et för handskriftsigenkänning med Windows Ink

Windows Ink tillhandahåller verktyg och tekniker för att möjliggöra digitala pennanteckningar på en mängd olika enheter. Du kan kombinera Windows Ink-plattformen med API:et för handskriftsigenkänning för att skapa program som visar och tolkar digitala pennstreck.

Nästa steg