1This library (com.android.media.remotedisplay.jar) is a shared java library 2containing classes required by unbundled remote display providers. 3 4--- Rules of this library --- 5o This library is effectively a PUBLIC API for unbundled remote display providers 6 that may be distributed outside the system image. So it MUST BE API STABLE. 7 You can add but not remove. The rules are the same as for the 8 public platform SDK API. 9o This library can see and instantiate internal platform classes, but it must not 10 expose them in any public method (or by extending them via inheritance). This would 11 break clients of the library because they cannot see the internal platform classes. 12 13This library is distributed in the system image, and loaded as 14a shared library. So you can change the implementation, but not 15the interface. In this way it is like framework.jar. 16 17--- Why does this library exists? --- 18 19Unbundled remote display providers (such as Cast) cannot use internal 20platform classes. 21 22This library will eventually be replaced when the media route provider 23infrastructure that is currently defined in the support library is reintegrated 24with the framework in a new API. That API isn't ready yet so this 25library is a compromise to make new capabilities available to the system 26without exposing the full surface area of the support library media 27route provider protocol. 28