feat: add support for 360° format detection

Author: b5i

Sources/YouTubeKit/YouTubeResponseTypes/VideoInfos/VideoInfosResponse.swift

@@ -40,6 +40,9 @@ public struct VideoInfosResponse: YouTubeResponse {
     ///     }
     /// }
     /// ```
+    ///
+    /// - Note: when putting this URL in an `AVURLAsset` to play it on macOS, you need to remove any potential VP9-format video from it, for example using a custom `AVAssetResourceLoaderDelegate`.
+    /// - Note: to see whether the stream is 360°, you can check if the `YT-EXT-PROJECTION-TYPE="equirectangular"` parameter is set in the .m3u8 playlist.
     public var streamingURL: URL?
 
     /// Array of thumbnails.

Sources/YouTubeKit/YouTubeResponseTypes/VideoInfos/VideoInfosWithDownloadFormatsResponse.swift

@@ -407,10 +407,11 @@ public struct VideoInfosWithDownloadFormatsResponse: YouTubeResponse {
 
     /// Struct representing a download format that contains the video and audio.
     public struct VideoDownloadFormat: DownloadFormat {
-        public init(averageBitrate: Int? = nil, contentDuration: Int? = nil, contentLength: Int? = nil, isCopyrightedMedia: Bool? = nil, mimeType: String? = nil, codec: String? = nil, url: URL? = nil, width: Int? = nil, height: Int? = nil, quality: String? = nil, fps: Int? = nil) {
+        public init(averageBitrate: Int? = nil, contentDuration: Int? = nil, contentLength: Int? = nil, is360: Bool? = nil, isCopyrightedMedia: Bool? = nil, mimeType: String? = nil, codec: String? = nil, url: URL? = nil, width: Int? = nil, height: Int? = nil, quality: String? = nil, fps: Int? = nil) {
             self.averageBitrate = averageBitrate
             self.contentDuration = contentDuration
             self.contentLength = contentLength
+            self.is360 = is360
             self.isCopyrightedMedia = isCopyrightedMedia
             self.mimeType = mimeType
             self.codec = codec
@@ -430,6 +431,8 @@ public struct VideoInfosWithDownloadFormatsResponse: YouTubeResponse {
 
         public var contentLength: Int?
 
+        public var is360: Bool?
+        
         public var isCopyrightedMedia: Bool?
 
         public var mimeType: String?
@@ -545,6 +548,7 @@ public struct VideoInfosWithDownloadFormatsResponse: YouTubeResponse {
                         return nil
                     }
                 }(),
+                is360: json["projectionType"].string == "MESH",
                 isCopyrightedMedia: json["signatureCipher"].string != nil,
                 mimeType: json["mimeType"].string?.ytkFirstGroupMatch(for: "([^;]*)"),
                 codec: json["mimeType"].string?.ytkFirstGroupMatch(for: #"codecs="([^\.]+)"#),

Tests/YouTubeKitTests/YouTubeKitTests.swift

@@ -689,6 +689,12 @@ final class YouTubeKitTests: XCTestCase {
         """,
             TEST_NAME + "Checking if testCaptionsResponse.getFormattedString(withFormat: .srt) is good."
         ) // srt integrity checked with https://taoning2014.github.io/srt-validator-website/index.html
+        
+        XCTAssertTrue(requestResult.downloadFormats.compactMap({$0 as? VideoInfosWithDownloadFormatsResponse.VideoDownloadFormat}).allSatisfy({$0.is360 == false}), TEST_NAME + "Checking if the is360 property is correctly set -> has to be false")
+        
+        // test 360 video
+        let video360result = try await YTVideo(videoId: "yVLfEHXQk08").fetchStreamingInfosThrowing(youtubeModel: YTM)
+        XCTAssertTrue(video360result.downloadFormats.compactMap({$0 as? VideoInfosWithDownloadFormatsResponse.VideoDownloadFormat}).allSatisfy({$0.is360 == true}), TEST_NAME + "Checking if the is360 property is correctly set -> has to be true")
     }
 
     func testVideoInfosWithDownloadFormatsResponse() async throws {