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 }
}