Skip to content

[camerax] Wrap classes to implement resolution configuration for video capture #4620

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 50 commits into from
Aug 15, 2023

Conversation

camsim99
Copy link
Contributor

@camsim99 camsim99 commented Jul 31, 2023

Wraps classes to implement resolution configuration for video capture. No functionality changes.

Part of flutter/flutter#120462.

Pre-launch Checklist

  • I read the Contributor Guide and followed the process outlined there for submitting PRs.
  • I read the Tree Hygiene wiki page, which explains my responsibilities.
  • I read and followed the relevant style guides and ran the auto-formatter. (Unlike the flutter/flutter repo, the flutter/packages repo does use dart format.)
  • I signed the CLA.
  • The title of the PR starts with the name of the package surrounded by square brackets, e.g. [shared_preferences]
  • I listed at least one issue that this PR fixes in the description above.
  • I updated pubspec.yaml with an appropriate new version according to the pub versioning philosophy, or this PR is exempt from version changes.
  • I updated CHANGELOG.md to add a description of the change, following repository CHANGELOG style.
  • I updated/added relevant documentation (doc comments with ///).
  • I added new tests to check the change I am making, or this PR is test-exempt.
  • All existing and new tests are passing.

@camsim99 camsim99 requested a review from a team August 8, 2023 16:54
/**
* Host API implementation for {@link QualitySelector}.
*
* <p>This class may handle instantiating and adding native object instances that are attached to a
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

extreme nit: I had to read this sentence a couple of times to understand it, maybe break it up? Also maybe remove "may"?

Also applies to other instances of this comment

Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

After further discussion, it seems like this comment is coming from the generator for the ...HostApiImpls, correct? Feel free to ignore if so.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ah yes this is coming from the generator.

/// camera represented by [cameraInfo].
Future<ResolutionInfo> getResolutionFromInstance(
CameraInfo cameraInfo, VideoQualityConstraint quality) async {
final int? cameraInfoIdentifier = instanceManager.getIdentifier(cameraInfo);
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we put a check after this that the identifier isn't null?

This pattern of int? foo = instanceManager.getIdentifier(bar) followed by //do something with foo! is pretty common in the ...FromInstance methods, but in every other case bar is passed in with this from the Wrapped class to the _WrappedHostApi, so we're pretty sure it exists.

But in this case, the bar is a different class entirely (CameraInfo, instead of QualitySelector), so it seems significantly more likely that someone makes the mistake of using an object that isn't actually in the instance manager.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

That's a really good point! Added a check below

QualitySelector.fromOrderedList(
{BinaryMessenger? binaryMessenger,
InstanceManager? instanceManager,
required this.qualityList,
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Do you think it would be good to add a check here that the list isn't empty?

We verify this on the Java side, but the error would end up being the result of code written in dart (i.e. a use of this constructor), so it may be easier to debug if the verification instead comes from the dart constructor.

It would be duplicated code, though, so I'm open to not making this change.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added an assert which I think is a happy medium since it will help developers debug.

@gmackall
Copy link
Member

A couple of comments on the dart code, but mostly documentation suggestions.

Mostly looks good though!

@camsim99 camsim99 requested a review from gmackall August 14, 2023 21:02
Copy link
Member

@gmackall gmackall left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM outside of 3 comment changes!

camsim99 and others added 4 commits August 15, 2023 10:04
…o/flutter/plugins/camerax/FallbackStrategyHostApiImpl.java

Co-authored-by: Gray Mackall <[email protected]>
…o/flutter/plugins/camerax/QualitySelectorHostApiImpl.java

Co-authored-by: Gray Mackall <[email protected]>
@camsim99 camsim99 added the autosubmit Merge PR when tree becomes green via auto submit App label Aug 15, 2023
@auto-submit auto-submit bot removed the autosubmit Merge PR when tree becomes green via auto submit App label Aug 15, 2023
@auto-submit
Copy link
Contributor

auto-submit bot commented Aug 15, 2023

auto label is removed for flutter/packages/4620, due to - The status or check suite version_check has failed. Please fix the issues identified (or deflake) before re-applying this label.

@camsim99 camsim99 added the autosubmit Merge PR when tree becomes green via auto submit App label Aug 15, 2023
@auto-submit auto-submit bot merged commit 003a6c0 into flutter:main Aug 15, 2023
engine-flutter-autoroll added a commit to engine-flutter-autoroll/flutter that referenced this pull request Aug 16, 2023
auto-submit bot pushed a commit to flutter/flutter that referenced this pull request Aug 16, 2023
flutter/packages@84218b9...9bf208f

2023-08-16 [email protected] Manual roll Flutter from 9b6945b to f0e7c51 (63 revisions) (flutter/packages#4719)
2023-08-15 [email protected] Update palette_generator_test.dart (flutter/packages#4720)
2023-08-15 [email protected] [pigeon] Fix typo in README.md (flutter/packages#4707)
2023-08-15 [email protected] [camerax] Explicitly remove READ_EXTERNAL_STORAGE permission (flutter/packages#4716)
2023-08-15 [email protected] [webview_flutter_platform_interface] Adds support for retrieving user agent (flutter/packages#4563)
2023-08-15 [email protected] [camerax] Wrap classes to implement resolution configuration for video capture (flutter/packages#4620)
2023-08-15 49699333+dependabot[bot]@users.noreply.github.com Bump github/codeql-action from 2.21.3 to 2.21.4 (flutter/packages#4706)

If this roll has caused a breakage, revert this CL and stop the roller
using the controls here:
https://autoroll.skia.org/r/flutter-packages-flutter-autoroll
Please CC [email protected],[email protected] on the revert to ensure that a human
is aware of the problem.

To file a bug in Flutter: https://github.com/flutter/flutter/issues/new/choose

To report a problem with the AutoRoller itself, please file a bug:
https://bugs.chromium.org/p/skia/issues/entry?template=Autoroller+Bug

Documentation for the AutoRoller is here:
https://skia.googlesource.com/buildbot/+doc/main/autoroll/README.md
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
autosubmit Merge PR when tree becomes green via auto submit App p: camera platform-android
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants