v4.0.01

Add `toArray()` to `quicktime` for `AudioMetadata`

Author: ewilan-riviere

composer.json

@@ -1,7 +1,7 @@
 {
     "name": "kiwilan/php-audio",
     "description": "PHP package to parse and update audio files metadata, with `JamesHeinrich/getID3`.",
-    "version": "4.0.0",
+    "version": "4.0.01",
     "keywords": [
         "audio",
         "php",

src/Id3/Reader/Id3AudioQuicktime.php

@@ -171,4 +171,35 @@ public function getMdat(): ?Id3AudioQuicktimeItem
     {
         return $this->mdat;
     }
+
+    public function getChapter(int $index): ?Id3AudioQuicktimeChapter
+    {
+        return $this->chapters[$index] ?? null;
+    }
+
+    public function toArray(): array
+    {
+        $chapters = [];
+        foreach ($this->chapters as $chapter) {
+            $chapters[] = $chapter->toArray();
+        }
+
+        return [
+            'hinting' => $this->hinting,
+            'controller' => $this->controller,
+            'ftyp' => $this->ftyp?->toArray(),
+            'timestamps_unix' => $this->timestamps_unix,
+            'time_scale' => $this->time_scale,
+            'display_scale' => $this->display_scale,
+            'video' => $this->video,
+            'audio' => $this->audio,
+            'stts_framecount' => $this->stts_framecount,
+            'comments' => $this->comments,
+            'chapters' => $chapters,
+            'free' => $this->free?->toArray(),
+            'wide' => $this->wide?->toArray(),
+            'mdat' => $this->mdat?->toArray(),
+            'encoding' => $this->encoding,
+        ];
+    }
 }

src/Id3/Reader/Id3AudioQuicktimeChapter.php

@@ -35,4 +35,12 @@ public function getTitle(): ?string
     {
         return $this->title;
     }
+
+    public function toArray(): array
+    {
+        return [
+            'timestamp' => $this->timestamp,
+            'title' => $this->title,
+        ];
+    }
 }

src/Id3/Reader/Id3AudioQuicktimeItem.php

@@ -75,4 +75,17 @@ public function getFourcc(): ?string
     {
         return $this->fourcc;
     }
+
+    public function toArray(): array
+    {
+        return [
+            'hierarchy' => $this->hierarchy,
+            'name' => $this->name,
+            'size' => $this->size,
+            'offset' => $this->offset,
+            'signature' => $this->signature,
+            'unknown_1' => $this->unknown_1,
+            'fourcc' => $this->fourcc,
+        ];
+    }
 }

src/Models/AudioMetadata.php

@@ -293,6 +293,8 @@ public function toArray(): array
             'data_format' => $this->data_format,
             'encoding' => $this->encoding,
             'mime_type' => $this->mime_type,
+            'quicktime' => $this->quicktime?->toArray(),
+            'warning' => $this->warning,
             'duration_seconds' => $this->duration_seconds,
             'bitrate' => $this->bitrate,
             'bitrate_mode' => $this->bitrate_mode,

tests/AudioMetadataTest.php

@@ -139,4 +139,6 @@
     expect($quicktime->getWide())->toBeInstanceOf(Id3AudioQuicktimeItem::class);
     expect($quicktime->getMdat())->toBeInstanceOf(Id3AudioQuicktimeItem::class);
     expect($quicktime->getEncoding())->toBeString();
+
+    expect($quicktime->toArray())->toBeArray();
 });

tests/AudiobookTest.php

@@ -148,7 +148,7 @@
     expect($quicktime->getChapters())->toBeArray();
     expect($quicktime->getChapters())->each(fn (Pest\Expectation $chapter) => expect($chapter->value)->toBeInstanceOf(Id3AudioQuicktimeChapter::class));
 
-    $first = $quicktime->getChapters()[0];
+    $first = $quicktime->getChapter(0);
     expect($first->getTimestamp())->toBe(0);
     expect($first->getTitle())->toBe('Chapter 01');
 });