[FEATURE] Midi player measure navigation

Classes/Common/AnnotationRequest.php

@@ -0,0 +1,78 @@
+<?php
+
+namespace Kitodo\Dlf\Common;
+
+/**
+ * (c) Kitodo. Key to digital objects e.V. <[email protected]>
+ *
+ * This file is part of the Kitodo and TYPO3 projects.
+ *
+ * @license GNU General Public License version 3 or later.
+ * For the full copyright and license information, please read the
+ * LICENSE.txt file that was distributed with this source code.
+ */
+
+class AnnotationRequest
+{
+ /**
+ * @var string
+ */
+ protected $apiUrl = '';
+
+ /**
+ * @param string $apiUrl The url of the annotation server api.
+ */
+ public function __construct($apiUrl)
+ {
+ $this->apiUrl = trim($apiUrl, "/ ");
+ }
+
+
+ /**
+ * Requests the annotation server
+ *
+ * @param string $url The annotation request url.
+ * @return array
+ */
+ protected function requestAnnotions($url) : array
+ {
+ $jsonld = Helper::getUrl($url);
+
+ if ($jsonld) {
+ $annotationData = json_decode($jsonld, true);
+
+ if ($annotationData) {
+ return $annotationData;
+ }
+ }
+
+ return [];
+ }
+
+ /**
+ * Returns all annotations of a document.
+ *
+ * @param string $id Document id (purl)
+ * @return array
+ */
+ public function getAll($id)
+ {
+ $annotations = [];
+
+ $annotationData = $this->requestAnnotions($this->apiUrl . '?target=' . urlencode($id . '/*'));
+
+ if (array_key_exists('first', $annotationData)) {
+ $annotationPageData = $annotationData['first'];
+ $annotations = array_merge($annotations, $annotationPageData["items"]);
+
+ while (array_key_exists('next', $annotationPageData)) {
+ $annotationPageData = $this->requestAnnotions($annotationPageData['next']);
+ if (array_key_exists('items', $annotationPageData)) {
+ $annotations = array_merge($annotations, $annotationPageData["items"]);
+ }
+ }
+ }
+
+ return $annotations;
+ }
+}

Classes/Common/Doc.php

@@ -382,6 +382,20 @@ public abstract function getDownloadLocation($id);
  */
  public abstract function getFileLocation($id);
 
+ /**
+ * Returns id of pb element representing the beginning of a physical page
+ *
+ * @access public
+ *
+ * @abstract
+ *
+ * @param string $pageId: The "@ID" attribute of the page node (METS)
+ * @param string $fileId: The "@ID" attribute of the file node (METS)
+ *
+ * @return string The node's id
+ */
+ public abstract function getPageBeginning($pageId, $fileId);
+
  /**
  * This gets the MIME type of a file representing a physical page or track
  *