A partir de la sesión 103 del Pista móvil Couchbase LIVE Nueva YorkEn Couchbase Lite, repasamos la característica de Couchbase Lite que nos permitiría habilitar la sincronización peer-to-peer entre dos o más dispositivos. Desde el "Couchbase Mobile 103": Construir una aplicación Peer-to-Peer con Couchbase Mobile" diapositivas, exploramos en profundidad el código y los componentes que permitían a la aplicación para compartir fotos intercambiar imágenes con otro dispositivo cliente que ejecutaba Couchbase Lite a través de la función P2P.
El ejemplo de aplicación P2P PhotoDrop puede encontrarse en el repositorio GitHub de iOS y Android. En este blog, vamos a recapitular a alto nivel las características y APIs de Couchbase Lite que se presentaron en la sesión Couchbase 103, así como parte del código que se encuentra en el ejemplo de Photo Sharing. Puedes hacer referencia a Couchbase Mobile 101 y 102 blogs para orientarse sobre cómo empezar.
Aquí están los storyboards de la aplicación donde tenemos tres simples ViewControllers donde el ViewController es el punto de entrada a la aplicación. El flujo UX comienza cuando el remitente selecciona las fotos del teléfono y hace clic en enviar. A continuación, la cámara se abrirá para escanear el código QR de recepción del otro teléfono con el fin de autenticar e iniciar la transferencia. Veamos los componentes principales del código de la aplicación que permite la función peer-to-peer de Couchbase Lite.
[1] Iniciar escucha
En el ReceiveViewController, ponemos el puerto a cero para que Couchbase Lite decida cual usar. Esto significa que cada vez que queramos compartir las fotos, el puerto irá cambiando cada vez que inicie una transferencia. Habilitamos la autenticación donde la autenticación es el digest y soportado por el listener de Couchbase Lite por defecto. Después de eso tenemos el nombre de usuario y contraseña y establecemos el nombre de usuario / contraseña para la autenticación. Después de lo cual, estamos listos para iniciar los oyentes.
iOS
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
oyente = CBLListener(director: CBLManager.sharedInstance(), puerto: 0) oyente.requiresAuth = verdadero deje nombre de usuario = secureGenerateKey(NSCharacterSet.URLUserAllowedCharacterSet()) deje contraseña = secureGenerateKey(NSCharacterSet.URLPasswordAllowedCharacterSet()) oyente.setPasswords([nombre de usuario : contraseña]) var éxito = oyente.iniciar(&error) si (éxito) { syncUrl = genearteSyncURL(oyente.URL, nombre de usuario: nombre de usuario, contraseña: contraseña, dbName: base de datos.nombre) startObserveDatabaseChange() } |
Una vez iniciado el listener, generamos la URL de sincronización del endpoint URL a la base de datos receptora utilizando la URL del listener con el nombre de usuario/contraseña y con el nombre de la base de datos. Establecemos la URL en la variable de URL de sincronización y la utilizamos más tarde cuando generamos el código QR desde el que iniciamos los oyentes de cambio de base de datos en consecuencia.
[2] Observar los cambios en la base de datos
Iniciamos el escuchador de cambios de la base de datos para saber cuándo se sincroniza la foto con la base de datos del receptor. Cuando esto ocurre, obtenemos las fotos compartidas de los documentos compartidos y las aceptamos en el dispositivo.
iOS
|
1 2 3 4 5 6 7 8 9 10 11 12 |
func startObserveDatabaseChange() { NSNotificationCenter.defaultCenter().addObserverForName( kCBLDatabaseChangeNotification, objeto: base de datos, cola: nil) { (notificación) -> Vacío en si deje cambia = notificación.userInfo!["cambios"] como? [CBLDatabaseChange] { para cambiar en cambia { dispatch_async(dispatch_get_main_queue(), { auto.saveImageFromDocument(cambiar.documentID) }) } } } } |
[3] Generar y mostrar código QR
Para el último paso del ReceiveViewController donde una vez que tenemos los listeners de Couchbase Lite, configuramos los listeners compartidos de la base de datos y luego tenemos la URL de Sync. Con la URL de sincronización, podemos generar el código QR. Para ello utilizamos el filtro de imágenes del núcleo de iOS. El código QR contiene el puerto de escucha y el nombre de usuario/contraseña para la autenticación.
[4] Escanear código QR
Ahora dentro del SendViewController, usamos la clase de iOS AVCaptureSession, que es parte del framework AV Foundation con el tipo de salida AVMetadataObjectTypeQRCode. Esto nos permitirá ahora subir el escáner de código QR y escanear el código QR.
[5] Crear documentos
Ahora iteramos sobre las fotos que queremos enviar a los receptores. Para cada foto, creamos un documento y luego adjuntamos la foto al documento para luego guardarlo en la base de datos. El último snippet, guardaremos los IDs de los documentos en la variable docIds que es una propiedad que se utilizará en el siguiente paso.
iOS
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 |
var docIds: [Cadena] = [] para activo en sharedAssets! { //... var datos = NSData(bytesNoCopy: imageBytes, longitud: búfer, freeWhenDone: verdadero) deje doc = base de datos.crearDocumento() deje rev = doc.nuevaRevisión() rev.setAttachmentNamed("foto", withContentType: "application/octet-stream", contenido: datos) deje guardado = rev.guardar(&error) si guardado != nil { docIds.añadir(doc.documentID) } } |
[6] Replicar documentos
El último paso ahora que tenemos la URL de sincronización que obtuvimos del código QR es replicar los documentos en consecuencia. Tenemos los documentos fotográficos de la base de datos y estamos listos para replicarlos desde el dispositivo cliente emisor al dispositivo receptor. Aquí creamos una replicación push con la URL de sincronización en la que enviamos el ID del documento al replicador para que el replicador busque los documentos del ID. Y como un paso opcional, establecemos los estados para los oyentes de cambio de replicación para capturar el estado actual.
iOS
|
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 |
replicador = base de datos.createPushReplication(url) replicador.documentIDs = docIds NSNotificationCenter.defaultCenter().addObserverForName(kCBLReplicationChangeNotification, objeto: replicador, cola: nil) { (notificación) -> Vacío en si auto.replicador.últimoError == nil { var totalCount = auto.replicador.cuentaCambios var completedCount = auto.replicador.completedChangesCount si completedCount > 0 && completedCount == totalCount { auto.statusLabel.texto = "Envío completado" } } else { self.statusLabel.text = "Envío de Abortar" } } replicador.iniciar() |
Resumen
Los puntos clave de la implementación de las aplicaciones Photodrop son que utiliza el código QR para el descubrimiento de pares, donde generamos un nombre de usuario y una contraseña de una sola vez para la autenticación. El código central para enviar/recibir fotos es de unas 100 líneas de código y no contiene ningún código que intervenga directamente en la comunicación de red.
