diff --git a/6.1curlcommands.md b/6.1curlcommands.md index efb2605..29c7e18 100644 --- a/6.1curlcommands.md +++ b/6.1curlcommands.md @@ -1753,5 +1753,39 @@ curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin ] }' ``` +### Smithsonian Voyager 3D model Previewer (beta) +__Note:__ Voyager supports multiple formats. Only *.glb (model/gltf-binary) is currently supported by the Previewer. +Also note that with current styling the Voyager app fills the window when launched as a separate page, so the usual +preview header/footer information doesn't show (and therefore isn't even requested from Dataverse). + +```bash +curl -X POST -H 'Content-type: application/json' http://localhost:8080/api/admin/externalTools -d \ +'{ + "displayName":"View 3D model", + "description":"Explore the 3D model file using Voyager.", + "toolName":"voyagerPreviewer", + "scope":"file", + "types":["preview"], + "toolUrl":"https://gdcc.github.io/dataverse-previewers/previewers/betatest/VoyagerPreview.html", + "toolParameters": { + "queryParameters":[ + {"fileid":"{fileId}"}, + {"siteUrl":"{siteUrl}"}, + {"datasetid":"{datasetId}"}, + {"datasetversion":"{datasetVersion}"}, + {"locale":"{localeCode}"} + ] + }, + "contentType":"model/gltf-binary", + "allowedApiCalls": [ + { + "name": "retrieveFileContents", + "httpMethod": "GET", + "urlTemplate": "/api/v1/access/datafile/{fileId}?gbrecs=true", + "timeOut": 3600 + } + ] +}' +``` diff --git a/README.md b/README.md index b2162bc..a68561e 100644 --- a/README.md +++ b/README.md @@ -72,7 +72,8 @@ The image previewer only works with image/tiff files on some browsers (as of ~Ja The original tools were developed through the [Qualitative Data Repository](https://qdr.syr.edu) but are being offered to the Dataverse community at large. -[qqmyers](https://github.com/qqmyers) - developer of the original previewer framework, contributions to the Rich Html Previewer +[qqmyers](https://github.com/qqmyers) - developer of the original previewer framework, contributions to the Rich Html Previewer, Voyager Previewer, updating to use signed URLs + The Spreadsheet Previewer was contributed by [anncie-pcss](https://github.com/anncie-pcss). [pdurbin](https://github.com/pdurbin) updated the retriever.js script to allow previewers to be embedded directly in the Dataverse file pages.