Release v4.2.47

Package.swift

@@ -12,8 +12,8 @@ let package = Package(
     targets: [
         .binaryTarget(
             name: "VirtuosoClientDownloadEngine",
-            url: "https://github.com/penthera/Download2Go-ios/releases/download/v4.2.46/VirtuosoClientDownloadEngine-spm.xcframework.zip",
-            checksum: "1427c58d6ac7b65619c2b1bc7d766f376aad7ed1e229d80d69dc8fd4f6f02300"
+            url: "https://github.com/penthera/Download2Go-ios/releases/download/v4.2.47/VirtuosoClientDownloadEngine-spm.xcframework.zip",
+            checksum: "f7e813c3d8001abef59186e4a967ca4060510eee60b6af4c0183757e57a4f870"
         )
     ]
 )

Tutorials/ObjC/Example15/Example15/AppDelegate.m

@@ -23,17 +23,18 @@ - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(
     //
     [VirtuosoLogger setLogLevel:kVL_LogVerbose];  // Verbose might be overkill for Production.
     [VirtuosoLogger enableLogsToFile:NO];
-    [VirtuosoSettings.instance setBool:YES forKey:@"VFM_BetaFeatures.EnableClientAds"];
-
-
-    [[VirtuosoSettings instance] allowRestrictedMimeTypesForEncryptionKeys:YES];
-    [[VirtuosoSettings instance] allowAdditionalMimeTypes:@[@"text/html"] forAssetType:kVDE_AssetTypeHLS andDataType:kVF_DataTypeStreamCC];
-    [[VirtuosoSettings instance] allowAdditionalMimeTypes:@[@"application/octet-stream"] forAssetType:kVDE_AssetTypeHSS andDataType:kVF_DataTypeManifest];
-
-    // kVF_DataTypeStreamAudio
-    [[VirtuosoSettings instance] allowAdditionalMimeTypes:@[@"application/octet-stream"] forAssetType:kVDE_AssetTypeHLS andDataType:kVF_DataTypeManifest];
-
 
+    [VirtuosoSettings instanceOnReady:^(VirtuosoSettings * _Nonnull instance) {
+        [instance setBool:YES forKey:@"VFM_BetaFeatures.EnableClientAds"];
+
+        [instance allowRestrictedMimeTypesForEncryptionKeys:YES];
+        [instance allowAdditionalMimeTypes:@[@"text/html"] forAssetType:kVDE_AssetTypeHLS andDataType:kVF_DataTypeStreamCC];
+        [instance allowAdditionalMimeTypes:@[@"application/octet-stream"] forAssetType:kVDE_AssetTypeHSS andDataType:kVF_DataTypeManifest];
+
+        // kVF_DataTypeStreamAudio
+        [instance allowAdditionalMimeTypes:@[@"application/octet-stream"] forAssetType:kVDE_AssetTypeHLS andDataType:kVF_DataTypeManifest];
+
+    }];
 
     return YES;
 }

Tutorials/ObjC/Example6/Example6/AppDelegate.m

@@ -23,7 +23,10 @@ - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(
     //
     [VirtuosoLogger setLogLevel:kVL_LogVerbose];  // Verbose might be overkill for Production.
     [VirtuosoLogger enableLogsToFile:NO];
-    [VirtuosoSettings.instance setBool:YES forKey:@"VFM_BetaFeatures.EnableClientAds"];
+
+    [VirtuosoSettings instanceOnReady:^(VirtuosoSettings * _Nonnull instance) {
+        [instance setBool:YES forKey:@"VFM_BetaFeatures.EnableClientAds"];
+    }];
 
     return YES;
 }

Tutorials/Podspecs/VirtuosoClientDownloadEngine.podspec

@@ -8,7 +8,7 @@
 
 Pod::Spec.new do |s|
   s.name             = 'VirtuosoClientDownloadEngine'
-  s.version          = '4.2.46'
+  s.version          = '4.2.47'
   s.summary          = 'A best-of-breed download and offline viewing solution for video.'
   s.homepage         = 'http://penthera.com'
   s.license          = { :type => 'Custom', :file => 'LICENSE' }

Tutorials/Podspecs/VirtuosoClientDownloadEngineWidevine.podspec

@@ -8,7 +8,7 @@
 
 Pod::Spec.new do |s|
   s.name             = 'VirtuosoClientDownloadEngineWidevine'
-  s.version          = '4.2.46'
+  s.version          = '4.2.47'
   s.summary          = 'A best-of-breed download and offline viewing solution for video.'
   s.homepage         = 'http://penthera.com'
   s.license          = { :type => 'Custom', :file => 'LICENSE' }

Tutorials/Swift/Example11/Example11/AppDelegate.swift

@@ -18,8 +18,10 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         VirtuosoLogger.setLogLevel(.vl_LogVerbose)          // Verbose might be overkill for Production.
         VirtuosoLogger.enableLogs(toFile: false)            // Setting to true will save Virtuoso logs to disk
 
-        VirtuosoSettings.instance().setBool(true, forKey: "VFM_Undocumented_EnableClientAds")
-
+        VirtuosoSettings.instance(onReady: {(instance:VirtuosoSettings)->Void in
+            instance.setBool(true, forKey: "VFM_Undocumented_EnableClientAds")
+        })
+
         return true
     }
 

Tutorials/Swift/Example15/Example15/AppDelegate.swift

@@ -17,12 +17,15 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
 
         VirtuosoLogger.setLogLevel(.vl_LogVerbose)          // Verbose might be overkill for Production.
         VirtuosoLogger.enableLogs(toFile: false)            // Setting to true will save Virtuoso logs to disk
-        VirtuosoSettings.instance().setBool(true, forKey:"VFM_BetaFeatures.EnableClientAds")
-
-        VirtuosoSettings.instance().allowRestrictedMimeTypes(forEncryptionKeys:true)
-        VirtuosoSettings.instance().allowAdditionalMimeTypes(["text/html"], for:.vde_AssetTypeHLS, andDataType:.vf_DataTypeStreamCC)
-        VirtuosoSettings.instance().allowAdditionalMimeTypes(["application/octet-stream"], for:.vde_AssetTypeHLS, andDataType:.vf_DataTypeManifest)
 
+        VirtuosoSettings.instance(onReady: {(instance:VirtuosoSettings)->Void in
+            instance.setBool(true, forKey:"VFM_BetaFeatures.EnableClientAds")
+
+            instance.allowRestrictedMimeTypes(forEncryptionKeys:true)
+            instance.allowAdditionalMimeTypes(["text/html"], for:.vde_AssetTypeHLS, andDataType:.vf_DataTypeStreamCC)
+            instance.allowAdditionalMimeTypes(["application/octet-stream"], for:.vde_AssetTypeHLS, andDataType:.vf_DataTypeManifest)
+        })
+
         return true
     }
 }

Tutorials/Swift/Example6/Example6/AppDelegate.swift

@@ -18,7 +18,9 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         VirtuosoLogger.setLogLevel(.vl_LogVerbose)          // Verbose might be overkill for Production.
         VirtuosoLogger.enableLogs(toFile: false)            // Setting to true will save Virtuoso logs to disk
 
-        VirtuosoSettings.instance().setBool(true, forKey: "VFM_BetaFeatures.EnableClientAds")
+        VirtuosoSettings.instance(onReady: {(instance:VirtuosoSettings)->Void in
+            instance.setBool(true, forKey: "VFM_BetaFeatures.EnableClientAds")
+        })
 
         return true
     }

Tutorials/Swift/Example7/Example7/AppDelegate.swift

@@ -17,8 +17,10 @@ class AppDelegate: UIResponder, UIApplicationDelegate {
         VirtuosoLogger.setLogLevel(.vl_LogVerbose)          // Verbose might be overkill for Production.
         VirtuosoLogger.enableLogs(toFile: false)            // Setting to true will save Virtuoso logs to disk
 
-        VirtuosoSettings.instance().setBool(true, forKey: "VFM_Undocumented_EnableClientAds")
-
+        VirtuosoSettings.instance(onReady: {(instance:VirtuosoSettings)->Void in
+            instance.setBool(true, forKey: "VFM_Undocumented_EnableClientAds")
+        })
+
         // Register Playlist delegate
         VirtuosoPlaylistManager.setDelegate(PlaylistDelegateProvider())
 

VirtuosoClientDownloadEngine.podspec

@@ -8,12 +8,12 @@
 
 Pod::Spec.new do |s|
   s.name             = 'VirtuosoClientDownloadEngine'
-  s.version          = '4.2.46'
+  s.version          = '4.2.47'
   s.summary          = 'A best-of-breed download and offline viewing solution for video.'
   s.homepage         = 'http://penthera.com'
   s.license          = { :type => 'Custom', :file => 'LICENSE' }
   s.author           = { 'josh-penthera' => '[email protected]' }
-  s.source           = { :http => 'https://github.com/penthera/Download2Go-ios/releases/download/v4.2.46/VirtuosoClientDownloadEngine.xcframework.zip' }
+  s.source           = { :http => 'https://github.com/penthera/Download2Go-ios/releases/download/v4.2.47/VirtuosoClientDownloadEngine.xcframework.zip' }
 
   s.ios.deployment_target = '11.0'
 

VirtuosoClientDownloadEngineWidevine.podspec

@@ -8,12 +8,12 @@
 
 Pod::Spec.new do |s|
   s.name             = 'VirtuosoClientDownloadEngineWidevine'
-  s.version          = '4.2.46'
+  s.version          = '4.2.47'
   s.summary          = 'A best-of-breed download and offline viewing solution for video.'
   s.homepage         = 'http://penthera.com'
   s.license          = { :type => 'Custom', :file => 'LICENSE' }
   s.author           = { 'josh-penthera' => '[email protected]' }
-  s.source           = { :http => 'https://github.com/penthera/Download2Go-ios/releases/download/v4.2.46/VirtuosoClientDownloadEngineWidevine.xcframework.zip' }
+  s.source           = { :http => 'https://github.com/penthera/Download2Go-ios/releases/download/v4.2.47/VirtuosoClientDownloadEngineWidevine.xcframework.zip' }
 
   s.ios.deployment_target = '11.0'
 

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug-Widevine/VirtuosoClientDownloadEngine.xcframework/Info.plist

@@ -6,29 +6,29 @@
 	<array>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>VirtuosoClientDownloadEngine.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
-				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>VirtuosoClientDownloadEngine.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
-				<string>x86_64</string>
+				<string>arm64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug-Widevine/VirtuosoClientDownloadEngine.xcframework/ios-arm64/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettings.h

@@ -44,14 +44,19 @@
 /*!
  *  @abstract The singleton instance access method
  *
- *  @discussion You must never instantiate a local copy of the VirtuosoSettings object.  This object
- *              is intended to be a static singleton accessed through the instance method only.  Instantiating a local
+ *  @discussion If the VirtuosoSettings instance has already been initiazlied, then this method immediately calls the given
+ *              block synchronously on the calling thread.  If the instance has not been initialized, then this method
+ *              initializes the instance in a background thread and later executes the provided block on the calling thread.
+ *
+ *  @warning   You must never instantiate a local copy of the VirtuosoSettings object.  This object
+ *              is intended to be a static singleton accessed through appropriate instance methods only.  Instantiating a local
  *              copy will throw an exception.
  *
- *  @return Returns the VirtuosoSettings object instance.
+ *  @property onReady - This block will be called on the calling thread immediately or after any required VirtuosoSettings initialization is complete.
+ *                    The instance is passed as a parameter to the handler.
+ *
  */
-+ (nonnull VirtuosoSettings*)instance;
-
++ (void)instanceOnReady:(void (^_Nonnull)(VirtuosoSettings* _Nonnull))onReady;
 
 /**---------------------------------------------------------------------------------------
  * @name Backplane-Provided Configuration

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug-Widevine/VirtuosoClientDownloadEngine.xcframework/ios-arm64/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettingsBase.h

@@ -21,7 +21,7 @@
 
 @interface VirtuosoSettingsBase : NSObject
 
--(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
++(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
 
 -(void)registerDefaults:(NSDictionary<NSString *,id>* _Nonnull)registrationDictionary;
 

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug-Widevine/VirtuosoClientDownloadEngine.xcframework/ios-x86_64-simulator/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettings.h

@@ -44,14 +44,19 @@
 /*!
  *  @abstract The singleton instance access method
  *
- *  @discussion You must never instantiate a local copy of the VirtuosoSettings object.  This object
- *              is intended to be a static singleton accessed through the instance method only.  Instantiating a local
+ *  @discussion If the VirtuosoSettings instance has already been initiazlied, then this method immediately calls the given
+ *              block synchronously on the calling thread.  If the instance has not been initialized, then this method
+ *              initializes the instance in a background thread and later executes the provided block on the calling thread.
+ *
+ *  @warning   You must never instantiate a local copy of the VirtuosoSettings object.  This object
+ *              is intended to be a static singleton accessed through appropriate instance methods only.  Instantiating a local
  *              copy will throw an exception.
  *
- *  @return Returns the VirtuosoSettings object instance.
+ *  @property onReady - This block will be called on the calling thread immediately or after any required VirtuosoSettings initialization is complete.
+ *                    The instance is passed as a parameter to the handler.
+ *
  */
-+ (nonnull VirtuosoSettings*)instance;
-
++ (void)instanceOnReady:(void (^_Nonnull)(VirtuosoSettings* _Nonnull))onReady;
 
 /**---------------------------------------------------------------------------------------
  * @name Backplane-Provided Configuration

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug-Widevine/VirtuosoClientDownloadEngine.xcframework/ios-x86_64-simulator/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettingsBase.h

@@ -21,7 +21,7 @@
 
 @interface VirtuosoSettingsBase : NSObject
 
--(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
++(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
 
 -(void)registerDefaults:(NSDictionary<NSString *,id>* _Nonnull)registrationDictionary;
 

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/Info.plist

@@ -6,15 +6,18 @@
 	<array>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64</string>
+			<string>ios-arm64_x86_64-simulator</string>
 			<key>LibraryPath</key>
 			<string>VirtuosoClientDownloadEngine.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
+				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
+			<key>SupportedPlatformVariant</key>
+			<string>simulator</string>
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
@@ -33,18 +36,15 @@
 		</dict>
 		<dict>
 			<key>LibraryIdentifier</key>
-			<string>ios-arm64_x86_64-simulator</string>
+			<string>ios-arm64</string>
 			<key>LibraryPath</key>
 			<string>VirtuosoClientDownloadEngine.framework</string>
 			<key>SupportedArchitectures</key>
 			<array>
 				<string>arm64</string>
-				<string>x86_64</string>
 			</array>
 			<key>SupportedPlatform</key>
 			<string>ios</string>
-			<key>SupportedPlatformVariant</key>
-			<string>simulator</string>
 		</dict>
 	</array>
 	<key>CFBundlePackageType</key>

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/ios-arm64/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettings.h

@@ -44,14 +44,19 @@
 /*!
  *  @abstract The singleton instance access method
  *
- *  @discussion You must never instantiate a local copy of the VirtuosoSettings object.  This object
- *              is intended to be a static singleton accessed through the instance method only.  Instantiating a local
+ *  @discussion If the VirtuosoSettings instance has already been initiazlied, then this method immediately calls the given
+ *              block synchronously on the calling thread.  If the instance has not been initialized, then this method
+ *              initializes the instance in a background thread and later executes the provided block on the calling thread.
+ *
+ *  @warning   You must never instantiate a local copy of the VirtuosoSettings object.  This object
+ *              is intended to be a static singleton accessed through appropriate instance methods only.  Instantiating a local
  *              copy will throw an exception.
  *
- *  @return Returns the VirtuosoSettings object instance.
+ *  @property onReady - This block will be called on the calling thread immediately or after any required VirtuosoSettings initialization is complete.
+ *                    The instance is passed as a parameter to the handler.
+ *
  */
-+ (nonnull VirtuosoSettings*)instance;
-
++ (void)instanceOnReady:(void (^_Nonnull)(VirtuosoSettings* _Nonnull))onReady;
 
 /**---------------------------------------------------------------------------------------
  * @name Backplane-Provided Configuration

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/ios-arm64/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettingsBase.h

@@ -21,7 +21,7 @@
 
 @interface VirtuosoSettingsBase : NSObject
 
--(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
++(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
 
 -(void)registerDefaults:(NSDictionary<NSString *,id>* _Nonnull)registrationDictionary;
 

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/ios-arm64/ios-arm64_x86_64-maccatalyst/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettings.h

@@ -44,14 +44,19 @@
 /*!
  *  @abstract The singleton instance access method
  *
- *  @discussion You must never instantiate a local copy of the VirtuosoSettings object.  This object
- *              is intended to be a static singleton accessed through the instance method only.  Instantiating a local
+ *  @discussion If the VirtuosoSettings instance has already been initiazlied, then this method immediately calls the given
+ *              block synchronously on the calling thread.  If the instance has not been initialized, then this method
+ *              initializes the instance in a background thread and later executes the provided block on the calling thread.
+ *
+ *  @warning   You must never instantiate a local copy of the VirtuosoSettings object.  This object
+ *              is intended to be a static singleton accessed through appropriate instance methods only.  Instantiating a local
  *              copy will throw an exception.
  *
- *  @return Returns the VirtuosoSettings object instance.
+ *  @property onReady - This block will be called on the calling thread immediately or after any required VirtuosoSettings initialization is complete.
+ *                    The instance is passed as a parameter to the handler.
+ *
  */
-+ (nonnull VirtuosoSettings*)instance;
-
++ (void)instanceOnReady:(void (^_Nonnull)(VirtuosoSettings* _Nonnull))onReady;
 
 /**---------------------------------------------------------------------------------------
  * @name Backplane-Provided Configuration

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/ios-arm64/ios-arm64_x86_64-maccatalyst/VirtuosoClientDownloadEngine.framework/Headers/VirtuosoSettingsBase.h

@@ -21,7 +21,7 @@
 
 @interface VirtuosoSettingsBase : NSObject
 
--(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
++(Boolean)isVirtuosoKey:(NSString* _Nonnull)key;
 
 -(void)registerDefaults:(NSDictionary<NSString *,id>* _Nonnull)registrationDictionary;
 

VirtuosoClientEngine/VirtuosoClientDownloadEngine/Debug/VirtuosoClientDownloadEngine.xcframework/ios-arm64/ios-arm64_x86_64-maccatalyst/VirtuosoClientDownloadEngine.framework/Resources/Info.plist

@@ -3,7 +3,7 @@
 <plist version="1.0">
 <dict>
 	<key>BuildMachineOSBuild</key>
-	<string>22G90</string>
+	<string>22G91</string>
 	<key>CFBundleDevelopmentRegion</key>
 	<string>en</string>
 	<key>CFBundleExecutable</key>