API de retransmissão de dispositivos no Microsoft Graph (prévia)Device relay API in Microsoft Graph (preview)

Hoje, as pessoas interagem com vários dispositivos diariamente.Today, people interact with multiple devices on a daily basis. Os usuários geralmente iniciam tarefas de produtividade e atividades de entretenimento em um dispositivo e continuam em outro.Users often start productivity tasks and entertainment activities on one device and continue them on another. Para atender às necessidades de seus clientes, seus aplicativos precisam abranger dispositivos e plataformas.To meet your customers' needs, your apps need to seamlessly span devices and platforms.

Você pode usar as APIs de retransmissão de dispositivos para fornecer experiências perfeitas para seus usuários.You can use the device relay APIs to deliver seamless experiences to your users. Você pode permitir que eles transfiram ativamente uma experiência de um dispositivo para outro ou a aprimorem usando vários dispositivos ao mesmo tempo.You can make it possible for them to actively transfer an experience from one device to another or enhance it by using multiple devices at once. Isso é feito por meio de ações no aplicativo (um botão ou seleção no aplicativo) que chama a API de retransmissão de dispositivos para descobrir os dispositivos dos usuários e permitir que eles iniciem e enviem mensagens ao seu aplicativo nesses outros dispositivos.This is done via in-app actions (a button or selection in your app) that call the device relay API to discover users' devices, and enable them to launch and message your app on those other devices.

Por que integrar-se com a retransmissão de dispositivos?Why integrate with device relay?

A API de retransmissão de dispositivos permite que seu aplicativo se registre e descubra, comande e envie mensagens para seu aplicativo nos dispositivos do usuário.The device relay API enables your app to register itself, and discover, command, and message your app on the user's devices. Ao fazer isso, você pode tornar as tarefas nas quais seus clientes trabalham no tema central.By doing this, you can make the tasks your customers work on the central focus. Eles podem trabalhar no dispositivo que for mais conveniente para eles, descobrindo-o e transferindo tarefas para ele.They can work on the device that is most convenient for them by discovering it and transferring tasks to it. Eles também podem aprimorar uma experiência em andamento com o aplicativo usando outros dispositivos disponíveis.They can also enhance an ongoing experience with your app by using other devices around them.

Você pode usar a API de retransmissão de dispositivos para dispositivos complementares ou cenários de controle remoto.You can use the device relay API for companion devices, or remote control scenarios. Use os recursos de mensagens para criar um canal de aplicativos entre dois dispositivos para enviar e receber mensagens personalizadas.Use the messaging capabilities to create an app channel between two devices to send and receive custom messages. Por exemplo, você pode permitir que seus clientes usem o telefone para controlar a reprodução em uma TV.For example, you can enable your customers to use their phone to control playback on a TV. Em um cenário de produtividade, você também pode oferecer um aplicativo complementar exibindo ações comumente usadas baseadas em contexto em um telefone enquanto os usuários trabalham na visualização principal do aplicativo no PC.You could also provide a companion app in a productivity scenario by displaying context-based commonly used actions on a phone while your users work on the main view of your app in the PC.

Seus clientes também podem transferir ativamente uma experiência de um dispositivo para outro executando uma ação no seu aplicativo.Your customers can also actively transfer an experience from one device to another by performing an action in your app. Por exemplo, uma usuária pode estar assistindo a uma transmissão ao vivo no telefone enquanto está no ônibus, mas, ao chegar em casa, poderá transferir a reprodução para o PC em sua sala de estar.For example, a user might be watching a live broadcast on her phone while on the bus, but when she gets home she wants to transfer playback to the PC in her living room. Os cenários de produtividade também são compatíveis com a retransmissão de dispositivos.Productivity scenarios are also supported by device relay.

Estender a experiênciaExtend the experience

Estenda seu aplicativo oferecendo uma experiência do usuário para descobrir dispositivos e iniciar seu aplicativo nesses dispositivos.Extend your app by providing UX to discover devices and to launch your app on those devices. Por exemplo, o usuário poderia estar trabalhando em um pedido de compra no telefone, descobrir o PC no escritório e iniciar o aplicativo para terminar de inserir o pedido de compra.For example, the user could be working on a purchase order on her phone, discover the PC in her office, and launch the app there to finish entering the purchase order.

Aumente a experiênciaAugment the experience

Crie uma experiência complementar para seu aplicativo em outro dispositivos do usuário.Create a companion experience for your app on another of the user’s devices. Por exemplo, o aplicativo pode incluir uma experiência do usuário para iniciar em outros dispositivos.For example, the app could include UX to launch itself on other devices. Em um jogo, o usuário poderia iniciar o aplicativo em um dispositivo com uma tela maior (por exemplo, de um computador para um Xbox).In a game, the user could launch the app to a device with a larger screen (for example, from a PC to an Xbox). O Xbox poderia apresentar uma visão completa do jogo (uma visão em primeira pessoa), enquanto o dispositivo com a tela menor poderia apresentar uma visão diferente com contexto adicional (uma visão de nível superior do nível do jogo mostrando o jogador e as localizações dos adversários).The Xbox could present a full view of the game (a first-person view), while the device with the smaller screen could present a different view with additional context (a top-level view of the game level showing the player and opponents' locations).

Aprimorar a experiênciaEnrich the experience

Adicione mais habilidades de controle ao seu aplicativo.Add additional controlling abilities to your app. Por exemplo, forneça habilidades de controle remoto para o aplicativo principal de um dispositivo complementar.For example, provide remote control abilities for the main app from a companion device. Quando o usuário iniciasse um aplicativo de um dispositivo para outro, o dispositivo de destino poderia mostrar a experiência completa (por exemplo, um modelo 3D em um aplicativo de design), enquanto o dispositivo de origem poderia mostrar uma lista das ações mais comuns dependendo do estado do aplicativo no dispositivo de destino (por exemplo, girar, redimensionar, paleta de cores).When the user launches an app from one device to another, the target device could show the full experience (for example, a 3D model in a design app), while the source device could show a list of the most common actions given the state of the app on the target device (for example, rotate, resize, color palette).

Confira tambémSee also