Audio

API 참조

오디오 파일을 탐색하고 기기에서 재생을 제어합니다. 휴대폰이 미디어 플레이어 역할을 합니다.

타입 정의

bash

type Audio {
  id: ID!
  title: String!
  artist: String!
  path: String!
  duration: Int!         # milliseconds
  size: Int!             # bytes
  bucketId: String!
  albumFileId: String!   # use GET /fs?id=<albumFileId> for album art
  createdAt: String!
  updatedAt: String!
  tags: [Tag!]!
}

type PlaylistAudio {
  title: String!
  artist: String!
  path: String!
  duration: Int!         # milliseconds
}

enum MediaPlayMode {
  REPEAT_ALL
  REPEAT_ONE
  SHUFFLE
}

작업

query

audios

오디오 파일을 검색합니다. 모두 나열하려면 쿼리를 비워 두십시오.

bash

query GetAudios($offset: Int!, $limit: Int!, $query: String!, $sortBy: FileSortBy!) {
  audios(offset: $offset, limit: $limit, query: $query, sortBy: $sortBy) {
    id title artist path duration size bucketId albumFileId createdAt
    tags { id name }
  }
}

query

audioCount

쿼리와 일치하는 오디오 파일 수를 셉니다.

bash

query GetAudioCount($query: String!) {
  audioCount(query: $query)
}

mutation

playAudio

기기에서 오디오 파일 재생을 시작합니다. 재생 목록에 없으면 추가됩니다.

bash

mutation PlayAudio($path: String!) {
  playAudio(path: $path) { title artist path duration }
}

mutation

updateAudioPlayMode

재생 모드를 설정합니다.

bash

mutation UpdateAudioPlayMode($mode: MediaPlayMode!) {
  updateAudioPlayMode(mode: $mode)
}

mutation

clearAudioPlaylist

현재 재생 목록을 지우고 재생을 중지합니다.

bash

mutation ClearAudioPlaylist {
  clearAudioPlaylist
}

mutation

deletePlaylistAudio

파일 경로로 재생 목록에서 트랙 하나를 제거합니다.

bash

mutation DeletePlaylistAudio($path: String!) {
  deletePlaylistAudio(path: $path)
}

mutation

addPlaylistAudios

일치하는 최대 1,000개의 오디오 파일을 현재 재생 목록에 추가합니다.

bash

mutation AddPlaylistAudios($query: String!) {
  addPlaylistAudios(query: $query)
}

mutation

reorderPlaylistAudios

정렬된 파일 경로 목록을 제공하여 재생 목록을 다시 정렬합니다.

bash

mutation ReorderPlaylistAudios($paths: [String!]!) {
  reorderPlaylistAudios(paths: $paths)
}