clarify the federation aspect #47

what should others do and get in return via Immers.

Taking back the older perspective of "invinting" people to actually visit or "take a tour" of my mind, as represented by my notes, what would the social aspect entail?

public versus private versus non-social (see #32) spaces
publicly or visible only from friends favorited spaces
- including places and moments in spaces, see #24
  - including non 3D screenshots, cf ibid
friends list to faciliate invitation
sharing of text/code snippets
- for the environmment via e.g ?commands-url=, as mentioned in #12
- or to customize own shortcuts, cf #28
being able to "bring in" own commands to other spaces
social provenance or list of annotations from another person
- e.g inviting someone and letting them add content
- to disentengle from the "live" networking aspect

Note that most of this features would faciliate demonstration, remote demonstration in particular, but most likely to people already familiar with federation.

All sharing aspect should maintain provenance, cf #20 , so that an important text/code snippet is not just its content but also a way to backtrack to its source, similar to #56 .

Example of user case : porting the Future of Text symposium book not to an innert object but rather a graph of spaces where each chapter becomes a potential workshop on the topic where both social and knowledge interactions take place. The federated aspect then becomes how to faciliate quality social interactions.

See federation branch https://git.benetou.fr/utopiah/text-code-xr-engine/src/branch/federation

Started to learn deeper integration with :

Fetch and render friends list with online status and link to current location

immersClient.friendsList().then( r => r.map( u => { 
  console.log(u.profile.displayName); 
  if (u.profile.avatarImage) { console.log(u.profile.avatarImage) }
  if (u.locationURL) { console.log(u.locationURL) }
  if (u.locationName) { console.log(u.locationName) }
  // unsure what is the difference between location and destination
} ) )
// could replace console.log() by addNewNote()

Fetch and render one page of the user's activity feed

immersClient.feed().then( console.log )

Send an outgoing text chat message

immersClient.sendChatMessage("msg", "public", ["otherutopiah[immers.space]"])

That can then be read via

immersClient.addEventListener("immers-client-new-message", console.log )

Documentation

ToDo (cf session 1 logs)

Post note with 3d position/orientation (by setting client.place.location )

immersClient.place.location = { position: AFRAME.utils.coordinates.stringify( document.querySelector("#testnote").getAttribute("position") ), rotation: AFRAME.utils.coordinates.stringify( document.querySelector("#testnote").getAttribute("rotation") )}
msg = await immersClient.sendChatMessage( document.querySelector("#testnote").getAttribute("value"), "public" );

Add them to a collection for that room

 const noteswithlocationURL = "https://immers.space/collection/utopiah/notewithlocation"
immersClient.activities.add( msg, noteswithlocationURL)
immersClient.activities.actor.streams.notewithcollection = noteswithlocationURL
immersClient.activities.updateProfile( immersClient.activities.actor )

Refetch that collection on return and rerender the notes in place

noteswithlocation = await immersClient.activities.getObject(noteswithlocationURL)
immersClient.activities.getObject( noteswithlocation.first ).then( c => c.orderedItems.map( i => addNewNote(i.object.content, i.object.context.location.position) ) )