PlainApp
API 參考

投放

透過 app.capabilities 判斷功能支援,透過 app.access 和主機權限判斷存取授權。範例使用合成值;呼叫前請替換路徑、ID、輸入和篩選條件。

型別定義

graphql
type Mutation {
  addDlnaItem(item: DlnaMediaInput!): DlnaSenderState!
  castDlnaMedia(item: DlnaMediaInput!): DlnaSenderState!
  clearDlnaItems: DlnaSenderState!
  dlnaCast(rendererUdn: String!, url: String!, title: String!, mime: String!, type: DlnaCastType!): Boolean!
  exitDlna: DlnaSenderState!
  pauseDlna: DlnaSenderState!
  playDlna: DlnaSenderState!
  removeDlnaItem(path: String!): DlnaSenderState!
  removeDlnaItemAt(index: Int!): DlnaSenderState!
  reorderDlnaItems(from: Int!, to: Int!): DlnaSenderState!
  seekDlna(positionMs: Long!): DlnaSenderState!
  selectDlnaDevice(id: ID!): DlnaSenderState!
  startDlnaScan: DlnaSenderState!
  stopDlna: DlnaSenderState!
  stopDlnaScan: DlnaSenderState!
}

type Query {
  dlnaRenderers: [DlnaRenderer!]!
  dlnaSenderState: DlnaSenderState!
}

type Subscription {
  dlnaSenderChanged: DlnaSenderState!
}

enum DlnaCastType {
	AUDIO
	VIDEO
	IMAGE
}

input DlnaMediaInput {
	path: String!
	title: String!
	albumArt: String! = ""
	artist: String! = ""
	durationMs: Long! = 0
	type: DlnaCastType!
}

type DlnaRenderer {
	udn: String!
	name: String!
	manufacturer: String
	modelName: String
	location: String!
}

type DlnaSenderDevice {
	id: ID!
	hostAddress: String!
	name: String!
	location: String!
}

type DlnaSenderMedia {
	path: String!
	title: String!
	albumArt: String!
	artist: String!
	durationMs: Long!
	type: DlnaCastType!
}

type DlnaSenderState {
	version: Long!
	devices: [DlnaSenderDevice!]!
	currentDevice: DlnaSenderDevice
	items: [DlnaSenderMedia!]!
	currentUri: String!
	playing: Boolean!
	progressMs: Long!
	durationMs: Long!
	supportsCallback: Boolean!
}

scalar Long

操作

mutation

addDlnaItem

向 DLNA 傳送佇列追加媒體項。

graphql
mutation addDlnaItem($item: DlnaMediaInput!) {
  addDlnaItem(item: $item) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

castDlnaMedia

使用 DLNA 傳送端投放指定媒體項。

graphql
mutation castDlnaMedia($item: DlnaMediaInput!) {
  castDlnaMedia(item: $item) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

clearDlnaItems

清空 DLNA 傳送佇列。

graphql
mutation clearDlnaItems {
  clearDlnaItems { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

dlnaCast

將媒體 URL 及其中繼資料傳送給指定的 DLNA 播放裝置。

graphql
mutation dlnaCast($rendererUdn: String!, $url: String!, $title: String!, $mime: String!, $type: DlnaCastType!) {
  dlnaCast(rendererUdn: $rendererUdn, url: $url, title: $title, mime: $mime, type: $type)
}
mutation

exitDlna

離開目前 DLNA 傳送工作階段。

graphql
mutation exitDlna {
  exitDlna { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

pauseDlna

暫停所選 DLNA 播放裝置的播放。

graphql
mutation pauseDlna {
  pauseDlna { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

playDlna

開始或繼續所選 DLNA 播放裝置的播放。

graphql
mutation playDlna {
  playDlna { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

removeDlnaItem

按路徑移除佇列中的 DLNA 項目。

graphql
mutation removeDlnaItem($path: String!) {
  removeDlnaItem(path: $path) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

removeDlnaItemAt

按指定索引移除佇列中的 DLNA 項目。

graphql
mutation removeDlnaItemAt($index: Int!) {
  removeDlnaItemAt(index: $index) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

reorderDlnaItems

將佇列中的 DLNA 項目從一個索引移動到另一個索引。

graphql
mutation reorderDlnaItems($from: Int!, $to: Int!) {
  reorderDlnaItems(from: $from, to: $to) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

seekDlna

將 DLNA 播放位置跳轉到指定毫秒數。

graphql
mutation seekDlna($positionMs: Long!) {
  seekDlna(positionMs: $positionMs) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

selectDlnaDevice

選取已探索到的 DLNA 播放裝置進行播放。

graphql
mutation selectDlnaDevice($id: ID!) {
  selectDlnaDevice(id: $id) { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

startDlnaScan

開始發現 DLNA 播放裝置。

graphql
mutation startDlnaScan {
  startDlnaScan { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

stopDlna

停止所選 DLNA 播放裝置的播放。

graphql
mutation stopDlna {
  stopDlna { version currentUri playing progressMs durationMs supportsCallback }
}
mutation

stopDlnaScan

停止發現 DLNA 播放裝置。

graphql
mutation stopDlnaScan {
  stopDlnaScan { version currentUri playing progressMs durationMs supportsCallback }
}
query

dlnaRenderers

列出已發現的 DLNA 播放裝置。

graphql
query dlnaRenderers {
  dlnaRenderers { udn name manufacturer modelName location }
}
query

dlnaSenderState

讀取目前 DLNA 傳送端、佇列和播放狀態,不啟動裝置發現。

graphql
query dlnaSenderState {
  dlnaSenderState { version currentUri playing progressMs durationMs supportsCallback }
}
subscription

dlnaSenderChanged

接收 DLNA 傳送端的初始快照和後續狀態變更。

graphql
subscription dlnaSenderChanged {
  dlnaSenderChanged { version currentUri playing progressMs durationMs supportsCallback }
}