Update section for mobile libraries

Author: dboltovskyi

proposals/0296-Update-video-streaming-capabilities-during-ignition-cycle.md

@@ -122,16 +122,16 @@ In `SDLStreamingMediaConfiguration`:
 @property (strong, nonatomic, nullable) SDLSupportedStreamingRange *supportedPortraitStreamingRange;
 
 @interface SDLSupportedStreamingRange : NSObject
-// The minimum supported normalized aspect ratio, Min value is 1
+// The minimum supported normalized aspect ratio, Min value is 1. (0 matches any ratio)
 @property (nonatomic, assign) float minimumAspectRatio;
-// The maximum supported normalized aspect ratio, Min value is 1
+// The maximum supported normalized aspect ratio, Min value is 1. (0 matches any ratio)
 @property (nonatomic, assign) float maximumAspectRatio;
 // The minimum supported diagonal screen size in inches, defaults to 0 (0 matches any size)
 @property (nonatomic, assign) float minimumDiagonal;
-// The minimum resolution to support, it overrides .minimumAspectRatio
-@property (nonatomic, assign) float minimumResolution;
-// The maximum resolution to support, it overrides .maximumAspectRatio
-@property (nonatomic, assign) float maximumResolution;
+// The minimum resolution to support
+@property (nonatomic, assign, nullable) SDLImageResolution *minimumResolution;
+// The maximum resolution to support
+@property (nonatomic, assign, nullable) SDLImageResolution *maximumResolution;
 // Check if the argument is within the [.minimumResolution, .maximumResolution] range
 - (BOOL)isImageResolutionInRange:(SDLImageResolution*)imageResolution;
 // Check if the argument is within the [.minimumAspectRatio, .maximumAspectRatio] range
@@ -142,50 +142,35 @@ In `SDLStreamingMediaConfiguration`:
 
 **Android**
 
-In `SdlRemoteDisplay`:
+In `VideoStreamManager` add new `startRemoteDisplayStream`:
 
 ```java
-public abstract Integer getMinSupportedWidth();
-public abstract Integer getMinSupportedHeight();
-public abstract Integer getMaxSupportedWidth();
-public abstract Integer getMaxSupportedHeight();
-public abstract double getMinScreenDiagonal();
-public abstract Double getMinAspectRatio();
-public abstract Double getMaxAspectRatio();
+public void startRemoteDisplayStream(Context context, Class<? extends SdlRemoteDisplay> remoteDisplayClass, VideoStreamingParameters parameters, final boolean encrypted, SupportedStreamingRange streamingRange)
 ```
 
-In `SdlRemoteDisplay` implementation by mobile application developers:
+In this way, developers will be able to pass constraints related to specific application directly into `SDLManager`
+where `SupportedStreamingRange`:
 
 ```java
-@Override
-public Integer getMinSupportedWidth() {
-  return 800;
-}
-@Override
-public Integer getMinSupportedHeight() {
-  return 600;
-}
-@Override
-public Integer getMaxSupportedWidth() {
-  return 1600;
-}
-@Override
-public Integer getMaxSupportedHeight() {
-  return 1200;
-}
-@Override
-public double getMinScreenDiagonal() {
-  return 6;
-}
-@Override
-public Double getMinAspectRatio() {
-  return 1.;
-}
-@Override
-public Double getMaxAspectRatio() {
-  return 4.;
+public class SupportedStreamingRange {
+    private Resolution minSupportedResolution;
+    private Resolution maxSupportedResolution;
+    private Double maxScreenDiagonal;
+    private AspectRatio aspectRatio;
 }
 ```
+In `SdlRemoteDisplay` implementation by mobile application developers:
+
+Later, when alternative supported resolutions are retrieved from `HMI`, `SupportedStreamingRange` will be used to unpack data:
+
+```java
+private List<VideoStreamingCapability> getSupportedCapabilities(
+    Resolution minResolution,
+    Resolution maxResolution,
+    Double constraintDiagonalMax,
+    AspectRatio ratioRange
+)
+```
 
 #### Resolution Switching