UNPKG

textiot

Version:

A framework for building web and native (IoT) Dapps on the IPFS network

528 lines (506 loc) 28.3 kB
<!DOCTYPE html> <html lang="en"> <head> <title>CafesApi Class Reference</title> <link rel="stylesheet" type="text/css" href="../css/jazzy.css" /> <link rel="stylesheet" type="text/css" href="../css/highlight.css" /> <meta charset='utf-8'> <script src="../js/jquery.min.js" defer></script> <script src="../js/jazzy.js" defer></script> </head> <body> <a name="//apple_ref/objc/Class/CafesApi" class="dashAnchor"></a> <a title="CafesApi Class Reference"></a> <header> <div class="content-wrapper"> <p><a href="../index.html">Textile Docs</a> (80% documented)</p> <p class="header-right"><a href="https://github.com/textileio/ios-textile"><img src="../img/gh.png"/>View on GitHub</a></p> </div> </header> <div class="content-wrapper"> <p id="breadcrumbs"> <a href="../index.html">Textile Reference</a> <img id="carat" src="../img/carat.png" /> CafesApi Class Reference </p> </div> <div class="content-wrapper"> <nav class="sidebar"> <ul class="nav-groups"> <li class="nav-group-name"> <a href="../Classes.html">Classes</a> <ul class="nav-group-tasks"> <li class="nav-group-task"> <a href="../Classes/AccountApi.html">AccountApi</a> </li> <li class="nav-group-task"> <a href="../Classes/CafesApi.html">CafesApi</a> </li> <li class="nav-group-task"> <a href="../Classes/CommentsApi.html">CommentsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/ContactsApi.html">ContactsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/FeedApi.html">FeedApi</a> </li> <li class="nav-group-task"> <a href="../Classes/FeedItemData.html">FeedItemData</a> </li> <li class="nav-group-task"> <a href="../Classes/FilesApi.html">FilesApi</a> </li> <li class="nav-group-task"> <a href="../Classes/FlagsApi.html">FlagsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/IgnoresApi.html">IgnoresApi</a> </li> <li class="nav-group-task"> <a href="../Classes/InvitesApi.html">InvitesApi</a> </li> <li class="nav-group-task"> <a href="../Classes/IpfsApi.html">IpfsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/LikesApi.html">LikesApi</a> </li> <li class="nav-group-task"> <a href="../Classes/LogsApi.html">LogsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/MessagesApi.html">MessagesApi</a> </li> <li class="nav-group-task"> <a href="../Classes/NotificationsApi.html">NotificationsApi</a> </li> <li class="nav-group-task"> <a href="../Classes/ProfileApi.html">ProfileApi</a> </li> <li class="nav-group-task"> <a href="../Classes/SchemasApi.html">SchemasApi</a> </li> <li class="nav-group-task"> <a href="../Classes/Textile.html">Textile</a> </li> <li class="nav-group-task"> <a href="../Classes/ThreadsApi.html">ThreadsApi</a> </li> </ul> </li> <li class="nav-group-name"> <a href="../Constants.html">Constants</a> <ul class="nav-group-tasks"> <li class="nav-group-task"> <a href="../Constants.html#/c:@TEXTILE_BACKGROUND_SESSION_ID">TEXTILE_BACKGROUND_SESSION_ID</a> </li> </ul> </li> <li class="nav-group-name"> <a href="../Protocols.html">Protocols</a> <ul class="nav-group-tasks"> <li class="nav-group-task"> <a href="../Protocols/TextileDelegate.html">TextileDelegate</a> </li> </ul> </li> <li class="nav-group-name"> <a href="../Type%20Definitions.html">Type Definitions</a> <ul class="nav-group-tasks"> <li class="nav-group-task"> <a href="../Type%20Definitions/FeedItemType.html">FeedItemType</a> </li> </ul> </li> </ul> </nav> <article class="main-content"> <section> <section class="section"> <h1>CafesApi</h1> <div class="declaration"> <div class="language"> <pre class="highlight objective_c"><code><span class="k">@interface</span> <span class="nc">CafesApi</span> <span class="p">:</span> <span class="nc">NodeDependant</span></code></pre> </div> </div> <p>Provides access to Textile cafes related APIs</p> </section> <section class="section task-group-section"> <div class="task-group"> <ul> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)register:token:completion:"></a> <a name="//apple_ref/objc/Method/-register:token:completion:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)register:token:completion:">-register:token:completion:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Used to register a remote Textile Cafe node with the local Textile node</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">register</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">url</span> <span class="nf">token</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">token</span> <span class="nf">completion</span><span class="p">:(</span><span class="n">nonnull</span> <span class="kt">void</span> <span class="p">(</span><span class="o">^</span><span class="p">)(</span><span class="n">NSError</span> <span class="o">*</span><span class="n">_Nonnull</span><span class="p">))</span><span class="nv">completion</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">register</span><span class="p">(</span><span class="n">_</span> <span class="nv">url</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">token</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">Error</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>url</em> </code> </td> <td> <div> <p>The url of the cafe being registered</p> </div> </td> </tr> <tr> <td> <code> <em>token</em> </code> </td> <td> <div> <p>The API token for the cafe being registered</p> </div> </td> </tr> <tr> <td> <code> <em>completion</em> </code> </td> <td> <div> <p>A block that will get called with an error</p> </div> </td> </tr> </tbody> </table> </div> </section> </div> </li> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)deregister:completion:"></a> <a name="//apple_ref/objc/Method/-deregister:completion:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)deregister:completion:">-deregister:completion:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Used to deregister a previously registered Textile Cafe</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">deregister</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">sessionId</span> <span class="nf">completion</span><span class="p">:(</span><span class="n">nonnull</span> <span class="kt">void</span> <span class="p">(</span><span class="o">^</span><span class="p">)(</span><span class="n">NSError</span> <span class="o">*</span><span class="n">_Nonnull</span><span class="p">))</span><span class="nv">completion</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">deregister</span><span class="p">(</span><span class="n">_</span> <span class="nv">sessionId</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">Error</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>sessionId</em> </code> </td> <td> <div> <p>The peer id of the cafe you want to deregister</p> </div> </td> </tr> <tr> <td> <code> <em>completion</em> </code> </td> <td> <div> <p>A block that will get called with an error</p> </div> </td> </tr> </tbody> </table> </div> </section> </div> </li> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)refreshSession:completion:"></a> <a name="//apple_ref/objc/Method/-refreshSession:completion:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)refreshSession:completion:">-refreshSession:completion:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Used to refresh an individual Textile Cafe session</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">refreshSession</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">sessionId</span> <span class="nf">completion</span><span class="p">:</span> <span class="p">(</span><span class="n">nonnull</span> <span class="kt">void</span> <span class="p">(</span><span class="o">^</span><span class="p">)(</span><span class="kt">int</span> <span class="o">*</span><span class="n">_Nullable</span><span class="p">,</span> <span class="n">NSError</span> <span class="o">*</span><span class="n">_Nonnull</span><span class="p">))</span><span class="nv">completion</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">refreshSession</span><span class="p">(</span><span class="n">_</span> <span class="nv">sessionId</span><span class="p">:</span> <span class="kt">String</span><span class="p">,</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">UnsafeMutablePointer</span><span class="o">&lt;</span><span class="kt">Int32</span><span class="o">&gt;</span><span class="p">?,</span> <span class="kt">Error</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>sessionId</em> </code> </td> <td> <div> <p>The peer id of the cafe who&rsquo;s session you want to refresh</p> </div> </td> </tr> <tr> <td> <code> <em>completion</em> </code> </td> <td> <div> <p>A block that will get called with the results of the refresh operation</p> </div> </td> </tr> </tbody> </table> </div> </section> </div> </li> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)checkMessages:"></a> <a name="//apple_ref/objc/Method/-checkMessages:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)checkMessages:">-checkMessages:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Check messages from all registered cafes</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="kt">void</span><span class="p">)</span><span class="nf">checkMessages</span><span class="p">:(</span><span class="n">nonnull</span> <span class="kt">void</span> <span class="p">(</span><span class="o">^</span><span class="p">)(</span><span class="n">NSError</span> <span class="o">*</span><span class="n">_Nonnull</span><span class="p">))</span><span class="nv">completion</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">checkMessages</span><span class="p">(</span><span class="n">_</span> <span class="nv">completion</span><span class="p">:</span> <span class="kd">@escaping</span> <span class="p">(</span><span class="kt">Error</span><span class="p">)</span> <span class="o">-&gt;</span> <span class="kt">Void</span><span class="p">)</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>completion</em> </code> </td> <td> <div> <p>A block that will get called with an error</p> </div> </td> </tr> </tbody> </table> </div> </section> </div> </li> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)session:error:"></a> <a name="//apple_ref/objc/Method/-session:error:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)session:error:">-session:error:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Fetches the CafeSession object for a previously registered Textile Cafe node</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">id</span><span class="p">)</span><span class="nf">session</span><span class="p">:(</span><span class="n">nonnull</span> <span class="n">NSString</span> <span class="o">*</span><span class="p">)</span><span class="nv">peerId</span> <span class="nf">error</span><span class="p">:(</span><span class="n">NSError</span> <span class="o">*</span><span class="n">_Nullable</span> <span class="o">*</span><span class="n">_Nullable</span><span class="p">)</span><span class="nv">error</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">session</span><span class="p">(</span><span class="n">_</span> <span class="nv">peerId</span><span class="p">:</span> <span class="kt">String</span><span class="p">)</span> <span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt">Any</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>peerId</em> </code> </td> <td> <div> <p>The peer id of the previously registered cafe node</p> </div> </td> </tr> <tr> <td> <code> <em>error</em> </code> </td> <td> <div> <p>A reference to an error pointer that will be set in the case of an error</p> </div> </td> </tr> </tbody> </table> </div> <div> <h4>Return Value</h4> <p>The CafeSession for the previously registered cafe</p> </div> </section> </div> </li> <li class="item"> <div> <code> <a name="/c:objc(cs)CafesApi(im)sessions:"></a> <a name="//apple_ref/objc/Method/-sessions:" class="dashAnchor"></a> <a class="token" href="#/c:objc(cs)CafesApi(im)sessions:">-sessions:</a> </code> </div> <div class="height-container"> <div class="pointer-container"></div> <section class="section"> <div class="pointer"></div> <div class="abstract"> <p>Used to get sessions for all previously registered Textile Cafes</p> </div> <div class="declaration"> <h4>Declaration</h4> <div class="language"> <p class="aside-title">Objective-C</p> <pre class="highlight objective_c"><code><span class="k">-</span> <span class="p">(</span><span class="n">id</span><span class="p">)</span><span class="nf">sessions</span><span class="p">:(</span><span class="n">NSError</span> <span class="o">*</span><span class="n">_Nullable</span> <span class="o">*</span><span class="n">_Nullable</span><span class="p">)</span><span class="nv">error</span><span class="p">;</span></code></pre> </div> <div class="language"> <p class="aside-title">Swift</p> <pre class="highlight swift"><code><span class="kd">func</span> <span class="nf">sessions</span><span class="p">()</span> <span class="k">throws</span> <span class="o">-&gt;</span> <span class="kt">Any</span></code></pre> </div> </div> <div> <h4>Parameters</h4> <table class="graybox"> <tbody> <tr> <td> <code> <em>error</em> </code> </td> <td> <div> <p>A reference to an error pointer that will be set in the case of an error</p> </div> </td> </tr> </tbody> </table> </div> <div> <h4>Return Value</h4> <p>An object containing a list of cafe sessions</p> </div> </section> </div> </li> </ul> </div> </section> </section> <section id="footer"> <p>&copy; 2019 <a class="link" href="https://textile.io" target="_blank" rel="external">Textile</a>. All rights reserved. (Last updated: 2019-11-19)</p> <p>Generated by <a class="link" href="https://github.com/realm/jazzy" target="_blank" rel="external">jazzy ♪♫ v0.12.0</a>, a <a class="link" href="https://realm.io" target="_blank" rel="external">Realm</a> project.</p> </section> </article> </div> </body> </div> </html>