didl toevoegingen

scribblings/didl-lite.scrbl

@@ -0,0 +1,45 @@
+#lang scribble/manual
+
+@(require
+  (for-label
+   racket/base
+   (file "../didl-lite.rkt")))
+
+@title{DIDL-Lite Metadata}
+
+@defmodule[(file "../didl-lite.rkt")]
+
+DIDL-Lite describes the resource passed to a renderer.  Some renderers only
+advertise seeking after the current URI has metadata containing its media
+type, duration, and byte-range capability.
+
+@defproc[(didl-lite-audio-item
+          [uri string?]
+          [#:protocol-info protocol-info string?]
+          [#:title title string? "Media"]
+          [#:duration duration (or/c #f nonnegative-real?) #f]
+          [#:size size (or/c #f exact-nonnegative-integer?) #f]
+          [#:id id string? "0"]
+          [#:parent-id parent-id string? "0"])
+         string?]{
+
+Returns an XML DIDL-Lite audio-item description.  Text and attribute values
+are XML-escaped automatically.
+
+The @racket[protocol-info] value must describe the HTTP resource accurately.
+For example:
+
+@racketblock[
+(didl-lite-audio-item
+ "http://10.7.3.118:8080/media/test.flac"
+ #:protocol-info
+ "http-get:*:audio/flac:DLNA.ORG_OP=01;DLNA.ORG_CI=0"
+ #:title "Test track"
+ #:duration 639
+ #:size 50357462)
+]
+
+Use @racket[media-file-server-didl-lite] when the URI was published with this
+package; it fills in the protocol information and file size from the actual
+publication.
+}