API 參考
SMS
簡訊與多媒體簡訊介面。
型別定義
graphql
type Subscription {
smsChanged: SmsProviderChange
smsSendResult: SmsSendResult!
}
type Mutation {
archiveSmsConversation(id: ID!, date: Instant): Boolean!
deleteSms(query: String!): ActionResult!
restoreSms(query: String!): ActionResult!
sendSms(number: String!, body: String!, attachmentPaths: [String!]! = [], subscriptionId: Int, requestId: String!): SmsSendReceipt!
trashSms(query: String!): ActionResult!
unarchiveSmsConversation(id: ID!): Boolean!
}
type Query {
archivedSmsConversations(query: String!, offset: Int!, limit: Int!): [SmsConversation!]!
sims: [Sim!]!
sms(query: String!, offset: Int!, limit: Int!): [Sms!]!
smsBoxCounts: SmsCounts!
smsConversationCount(query: String!): Int!
smsConversations(query: String!, offset: Int!, limit: Int!): [SmsConversation!]!
smsCount(query: String!): Int!
}
type ActionResult {
affectedCount: Int!
}
enum DataType {
DEFAULT
AUDIO
VIDEO
IMAGE
SMS
CONTACT
NOTE
FEED_ENTRY
CALL
PACKAGE
FILE
APP_FILE
DOC
}
scalar Instant
type Sim {
id: ID!
label: String!
number: String!
subscriptionId: Int!
}
type Sms {
id: ID!
body: String!
address: String!
sentAt: Instant!
serviceCenter: String!
read: Boolean!
threadId: ID!
type: SmsType!
typeCode: Int!
subscriptionId: Int!
isMms: Boolean!
attachments: [SmsAttachment!]!
tags: [Tag!]!
}
type SmsAttachment {
path: String!
contentType: String!
name: String!
}
type SmsConversation {
id: ID!
address: String!
snippet: String!
lastMessageAt: Instant!
messageCount: Int!
read: Boolean!
addresses: [String!]!
}
type SmsCounts {
total: Int!
inbox: Int!
sent: Int!
drafts: Int!
}
type SmsProviderChange {
uris: [String!]!
}
type SmsSendReceipt {
requestId: String!
requiresConfirmation: Boolean!
}
type SmsSendResult {
requestId: String!
success: Boolean!
resultCode: Int
}
enum SmsType {
INBOX
SENT
DRAFT
OUTBOX
FAILED
QUEUED
UNKNOWN
}
type Tag {
id: ID!
name: String!
type: DataType!
count: Int!
}操作
subscription
smsChanged
裝置上的簡訊有變更時通知用戶端重新整理簡訊清單,不傳回簡訊內容。
graphql
subscription smsChanged {
smsChanged { uris }
}subscription
smsSendResult
接收 SMS 与 MMS 的发送结果;用 requestId 对应 SmsSendReceipt.requestId。通过 success 判断结果,不要用 resultCode == 0:Android SMS 保留系统返回码(成功为 -1),MMS 成功为 0、超时为 -1000、取消为 -1001。发送成功不表示收件人已收到。
graphql
subscription smsSendResult {
smsSendResult { requestId success resultCode }
}mutation
archiveSmsConversation
封存訊息對話,並可選擇記錄封存日期。
graphql
mutation archiveSmsConversation($id: ID!, $date: Instant) {
archiveSmsConversation(id: $id, date: $date)
}mutation
deleteSms
永久刪除符合查詢條件的簡訊。
graphql
mutation deleteSms($query: String!) {
deleteSms(query: $query) { affectedCount }
}mutation
restoreSms
還原符合查詢條件的已移入資源回收筒的簡訊。
graphql
mutation restoreSms($query: String!) {
restoreSms(query: $query) { affectedCount }
}mutation
sendSms
傳送簡訊;有附件時編輯多媒體簡訊。
graphql
mutation sendSms($number: String!, $body: String!, $attachmentPaths: [String!]!, $subscriptionId: Int, $requestId: String!) {
sendSms(number: $number, body: $body, attachmentPaths: $attachmentPaths, subscriptionId: $subscriptionId, requestId: $requestId) { requestId requiresConfirmation }
}mutation
trashSms
將符合查詢條件的簡訊移入資源回收筒。
graphql
mutation trashSms($query: String!) {
trashSms(query: $query) { affectedCount }
}mutation
unarchiveSmsConversation
取消對話的封存狀態。
graphql
mutation unarchiveSmsConversation($id: ID!) {
unarchiveSmsConversation(id: $id)
}query
archivedSmsConversations
分頁搜尋已封存的簡訊對話。
graphql
query archivedSmsConversations($query: String!, $offset: Int!, $limit: Int!) {
archivedSmsConversations(query: $query, offset: $offset, limit: $limit) { id address snippet lastMessageAt messageCount read addresses }
}query
sims
列出裝置可用的 SIM 卡及電話帳戶。
graphql
query sims {
sims { id label number subscriptionId }
}query
sms
搜尋簡訊;query 為空字串時列出全部簡訊。
graphql
query sms($query: String!, $offset: Int!, $limit: Int!) {
sms(query: $query, offset: $offset, limit: $limit) { id body address sentAt serviceCenter read threadId type }
}query
smsBoxCounts
讀取各可用簡訊箱的訊息數。
graphql
query smsBoxCounts {
smsBoxCounts { total inbox sent drafts }
}query
smsConversationCount
統計符合查詢條件的簡訊對話數。
graphql
query smsConversationCount($query: String!) {
smsConversationCount(query: $query)
}query
smsConversations
分頁列出簡訊對話(討論串)。
graphql
query smsConversations($query: String!, $offset: Int!, $limit: Int!) {
smsConversations(query: $query, offset: $offset, limit: $limit) { id address snippet lastMessageAt messageCount read addresses }
}query
smsCount
統計符合查詢條件的簡訊數。
graphql
query smsCount($query: String!) {
smsCount(query: $query)
}