isabella232 / castvideos-android

Reference Android Sender w/ Framework API: CastVideos-android application shows how to cast videos from an Android device that is fully compliant with the Cast Design Checklist.

CastVideos-android (reference Android sender app)

This Google Cast demo app shows how to cast videos from an Android device in a way that is fully compliant with the Design Checklist.

This is a reference sender app to be used as the starting point for your Android sender app

List of reference apps and tutorials

Dependencies

• Android Volley library

Setup Instructions

1. Get a Google Cast device and get it set up for development: https://developers.google.com/cast/docs/developers#setup_for_development.
2. [Optional] Register an application on the Developers Console http://cast.google.com/publish. The easiest would be to use the Styled Media Receiver option. You will get an App ID when you finish registering your application. This project uses a published Application ID that can be used to run the app without using your own ID but if you need to do any console debugging, you would need to have your own ID.
3. Import the project into Android Studio or use gradle to build the project.
4. Compile and deploy to your Android device.
5. This sample includes a published app id in the res/values/strings.xml file so the project can be built and run without a need to register an app id. If you want to use your own receiver (which is required if you need to debug the receiver), update "app_id" in that file with your own app id.

Automated UI Testing on Cast Sender App

This Google Cast demo app also includes sample Cast test cases in androidTest/. It is recommended to implement and run automated testing for your Android sender app to ensure the best Cast experience for users.

How to run test cases

1. Update cast_test_target_device in [res/values/cast_test.xml] with your Google Cast device name.
2. Connect to a physical Android device and make sure your device is unlocked.
3. Follow Espresso setup instructions to turn off system animations under Settings > Developer options.
4. In Android Studio, click the Sync Project with Gradle Files button.
5. Go to CastTestSuite.java, right click and Run 'CastTestSuite' or right click to run single test case (ex: testCastingVideo()).
6. [Optional] Adjust timeout setting in [res/values/cast_test.xml] if necessary.

UI testing frameworks

• Espresso
• UI Automator
• Note: The UI Automator framework requires Android 4.3 (API level 18) or higher.

Documentation

• Google Cast Android Sender Overview
• Developer Guides

References

• Android Sender Reference
• Design Checklist

How to report bugs

• Google Cast SDK Support
• For sample app issues, open an issue on this GitHub repo.

Contributions

Please read and follow the steps in the CONTRIBUTING.md.

License

See LICENSE.

Terms

Your use of this sample is subject to, and by using or downloading the sample files you agree to comply with, the Google APIs Terms of Service and the Google Cast SDK Additional Developer Terms of Service.