Source: Ratta plugin host / sn-plugin-lib firmware release (as provided 2026-08-25).
NoteTaskBot uses a subset of these APIs. Impact on this plugin is marked below.
| API | NoteTaskBot |
|---|---|
PluginCommAPI.canHandwrite |
Unused |
PluginCommAPI.jumpToPage |
Unused |
PluginCommAPI.getPageDisplaySize |
Used as preferred current-page size for OCR / lasso quarter |
PluginCommAPI.flipLassoElements |
Unused |
PluginCommAPI.modifyPageElements / insertPageElements / deletePageElements / batchUpdatePageElements |
Unused |
PluginDocAPI.generateCurrentDocImage |
Unused (NOTE-only plugin) |
PluginFileAPI.openFile |
Unused |
PluginFileAPI.getPathEncryptionStatus / unlockPathWithPassword / lockPathAccess |
Unused (error 1217 if a path is locked) |
PluginManager.hasPermission / requestPermission |
Required — FILE:READ, FILE:WRITE (MyStyle config), INTERNET (Todoist) |
PluginManager.registerPluginLifeListener |
Unused |
Install cap is now 30 plugins; enabled cap is 10.
resizeLassoRectoptionalrotationDegree— unused.lassoElements(rect)must stay in page bounds — unused (we read the user lasso, we do not create one).- Page indices are 1-based (
numInPageand page arguments togetElement,getElementNumList,deleteElements,modifyPageElements/insertPageElements/deletePageElements/batchUpdatePageElements). TreatgetCurrentPageNum/getPageSizethe same:0means missing/legacy first page → use1.
getLassoElementscoordinates after dragging an image — helps lasso bounds.- Plugin upgrade cache cleanup — host-side; no plugin change.
Declare permissions before calling requestPermission (error 1500 otherwise):
"uses-permissions": [
"plugin.permission.FILE:READ",
"plugin.permission.FILE:WRITE",
"plugin.permission.INTERNET"
]