Better renderer and server support and higher level functions. Seek solutions.

scribblings/media-renderer.scrbl

@@ -71,6 +71,27 @@ included in the UPnP device description.
 
 @section{Playback}
 
+@defproc[(media-renderer-play-resource!
+          [renderer media-renderer?]
+          [uri string?]
+          [#:protocol-info protocol-info (or/c #f string?) #f]
+          [#:mime-type mime-type (or/c #f string?) #f]
+          [#:title title string? "Media"]
+          [#:artist artist (or/c #f string?) #f]
+          [#:album album (or/c #f string?) #f]
+          [#:genre genre (or/c #f string?) #f]
+          [#:year year (or/c #f exact-nonnegative-integer?) #f]
+          [#:track track (or/c #f exact-nonnegative-integer?) #f]
+          [#:duration duration (or/c #f number?) #f]
+          [#:size size (or/c #f exact-nonnegative-integer?) #f])
+         any]{
+
+Resolves missing DLNA HTTP capabilities, generates DIDL-Lite for the resource,
+and starts playback. A wildcard fourth field in @racket[protocol-info] is
+replaced with the server's @tt{contentFeatures.dlna.org} response when
+available. Successful capability responses are cached by URI.
+}
+
 @defproc[(media-renderer-play-uri!
           [renderer media-renderer?]
           [uri string?]
@@ -117,6 +138,25 @@ that resource, call this function again to preload the following track.  Use
 metadata that describes @racket[uri], not the current resource.
 }
 
+@defproc[(media-renderer-set-next-resource!
+          [renderer media-renderer?]
+          [uri string?]
+          [#:protocol-info protocol-info (or/c #f string?) #f]
+          [#:mime-type mime-type (or/c #f string?) #f]
+          [#:title title string? "Media"]
+          [#:artist artist (or/c #f string?) #f]
+          [#:album album (or/c #f string?) #f]
+          [#:genre genre (or/c #f string?) #f]
+          [#:year year (or/c #f exact-nonnegative-integer?) #f]
+          [#:track track (or/c #f exact-nonnegative-integer?) #f]
+          [#:duration duration (or/c #f number?) #f]
+          [#:size size (or/c #f exact-nonnegative-integer?) #f])
+         any]{
+
+Resolves and describes an external resource like
+@racket[media-renderer-play-resource!], then installs it as the next URI.
+}
+
 @defproc[(media-renderer-pause! [renderer media-renderer?]) any]
 @defproc[(media-renderer-stop! [renderer media-renderer?]) any]
 @defproc[(media-renderer-seek!