AVAssetImageDataProvider.swift 5.0 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137
  1. //
  2. // AVAssetImageDataProvider.swift
  3. // Kingfisher
  4. //
  5. // Created by onevcat on 2020/08/09.
  6. //
  7. // Copyright (c) 2020 Wei Wang <onevcat@gmail.com>
  8. //
  9. // Permission is hereby granted, free of charge, to any person obtaining a copy
  10. // of this software and associated documentation files (the "Software"), to deal
  11. // in the Software without restriction, including without limitation the rights
  12. // to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
  13. // copies of the Software, and to permit persons to whom the Software is
  14. // furnished to do so, subject to the following conditions:
  15. //
  16. // The above copyright notice and this permission notice shall be included in
  17. // all copies or substantial portions of the Software.
  18. //
  19. // THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  20. // IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  21. // FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
  22. // AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  23. // LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  24. // OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  25. // THE SOFTWARE.
  26. #if !os(watchOS)
  27. import Foundation
  28. import AVKit
  29. #if canImport(MobileCoreServices)
  30. import MobileCoreServices
  31. #else
  32. import CoreServices
  33. #endif
  34. /// A data provider to provide thumbnail data from a given AVKit asset.
  35. public struct AVAssetImageDataProvider: ImageDataProvider {
  36. /// The possible error might be caused by the `AVAssetImageDataProvider`.
  37. /// - userCancelled: The data provider process is cancelled.
  38. /// - invalidImage: The retrieved image is invalid.
  39. public enum AVAssetImageDataProviderError: Error {
  40. case userCancelled
  41. case invalidImage(_ image: CGImage?)
  42. }
  43. /// The asset image generator bound to `self`.
  44. public let assetImageGenerator: AVAssetImageGenerator
  45. /// The time at which the image should be generate in the asset.
  46. public let time: CMTime
  47. private var internalKey: String {
  48. return (assetImageGenerator.asset as? AVURLAsset)?.url.absoluteString ?? UUID().uuidString
  49. }
  50. /// The cache key used by `self`.
  51. public var cacheKey: String {
  52. return "\(internalKey)_\(time.seconds)"
  53. }
  54. /// Creates an asset image data provider.
  55. /// - Parameters:
  56. /// - assetImageGenerator: The asset image generator controls data providing behaviors.
  57. /// - time: At which time in the asset the image should be generated.
  58. public init(assetImageGenerator: AVAssetImageGenerator, time: CMTime) {
  59. self.assetImageGenerator = assetImageGenerator
  60. self.time = time
  61. }
  62. /// Creates an asset image data provider.
  63. /// - Parameters:
  64. /// - assetURL: The URL of asset for providing image data.
  65. /// - time: At which time in the asset the image should be generated.
  66. ///
  67. /// This method uses `assetURL` to create an `AVAssetImageGenerator` object and calls
  68. /// the `init(assetImageGenerator:time:)` initializer.
  69. ///
  70. public init(assetURL: URL, time: CMTime) {
  71. let asset = AVAsset(url: assetURL)
  72. let generator = AVAssetImageGenerator(asset: asset)
  73. self.init(assetImageGenerator: generator, time: time)
  74. }
  75. /// Creates an asset image data provider.
  76. ///
  77. /// - Parameters:
  78. /// - assetURL: The URL of asset for providing image data.
  79. /// - seconds: At which time in seconds in the asset the image should be generated.
  80. ///
  81. /// This method uses `assetURL` to create an `AVAssetImageGenerator` object, uses `seconds` to create a `CMTime`,
  82. /// and calls the `init(assetImageGenerator:time:)` initializer.
  83. ///
  84. public init(assetURL: URL, seconds: TimeInterval) {
  85. let time = CMTime(seconds: seconds, preferredTimescale: 600)
  86. self.init(assetURL: assetURL, time: time)
  87. }
  88. public func data(handler: @escaping (Result<Data, Error>) -> Void) {
  89. assetImageGenerator.generateCGImagesAsynchronously(forTimes: [NSValue(time: time)]) {
  90. (requestedTime, image, imageTime, result, error) in
  91. if let error = error {
  92. handler(.failure(error))
  93. return
  94. }
  95. if result == .cancelled {
  96. handler(.failure(AVAssetImageDataProviderError.userCancelled))
  97. return
  98. }
  99. guard let cgImage = image, let data = cgImage.jpegData else {
  100. handler(.failure(AVAssetImageDataProviderError.invalidImage(image)))
  101. return
  102. }
  103. handler(.success(data))
  104. }
  105. }
  106. }
  107. extension CGImage {
  108. var jpegData: Data? {
  109. guard let mutableData = CFDataCreateMutable(nil, 0),
  110. let destination = CGImageDestinationCreateWithData(mutableData, kUTTypeJPEG, 1, nil)
  111. else {
  112. return nil
  113. }
  114. CGImageDestinationAddImage(destination, self, nil)
  115. guard CGImageDestinationFinalize(destination) else { return nil }
  116. return mutableData as Data
  117. }
  118. }
  119. #endif